dwl-patches

Welcome to dwl-patches!
The dwl project is available at https://codeberg.org/dwl/dwl.
This repository and the associated wiki is exclusively for dwl PATCHES.

Patching

Since dwl follows suckless philosophy it doesn't provide every feature under the sun. To broaden dwl's functionality one needs to get familiar with a concept of patching. To get your feet wet, consult the hacking page of the suckless website. Once you're ready to customize your build, proceed to the dwl-patches wiki which contains a categorized listing and a directly searchable sidebar listing of all available patches.

Note: these external patches are user-submitted content, and the authors of dwl cannot monitor them. Please download and review a patch before using it!

Creating Patches

Create a Codeberg account and fork the dwl repository.
Create a branch in your repository for the patch you are generating and maintaining.
Make AND TEST the modifications for your patch.

Contributing Patches to this Wiki

If work has been done to the main branch at dwl since you started work on your patch, REBASE YOUR PATCH!
In your local clone of your codeberg dwl fork, add a remote for the main dwl repository:
git remote add codeberg-dwl https://codeberg.org/dwl/dwl
In your local clone of your codeberg dwl fork, create a .patch file git --diff codeberg-dwl/main > PATCHNAME.patch
Fork https://codeberg.org/dwl/dwl-patches
In your dwl-patches fork, add a directory called PATCHNAME and place the PATCHNAME.patch you created in the PATCHNAME directory. You may also place screenshots in the PATCHNAME directory that you can later reference in your dwl-patches wiki entry.
Use the Codeberg web interface to send a pull request (PR) to dwl-patches (NOT to dwl)
WHEN YOUR PULL REQUEST IS APPROVED, your Codeberg user will have commit access to dwl-patches and you can then replace your PATCHNAME.patch file when you updated it. At this point, you will also have access to commit to the dwl-patches wiki

Add a wiki page using this template (add/remove sections as you like):

### Description
Insert a short summary of changes that your patch implements.

### Download
- [yyyy-mm-dd](https://codeberg.org/dwl/dwl-patches/src/branch/main/PATCHNAME/PATCHNAME.patch)

### Authors
- [Your Name](https://codeberg.org/YOURUSERNAME)

Add your patch to the dwl-patches wiki categorized list and alphabetized sidebar using this template:
```
* [PATCHNAME](https://codeberg.org/dwl/dwl-patches/wiki/PATCHNAME)
```
Keep your PATCHNAME.patch file AND the associated wiki page updated appropriately.