diff options
| author | Sadeep Madurange <sadeep@asciimx.com> | 2025-12-20 11:25:26 +0800 |
|---|---|---|
| committer | Sadeep Madurange <sadeep@asciimx.com> | 2025-12-20 11:25:26 +0800 |
| commit | 8cbe75f0047732c865f58e2f847a5ffafe066e71 (patch) | |
| tree | acd75f1a370bbdcc83db4cdaab481fb700c78db9 /_site/blog/suckless-software/index.html | |
| parent | 9ac8970b08550a83e9ba686d0e9357654373a047 (diff) | |
| download | www-8cbe75f0047732c865f58e2f847a5ffafe066e71.tar.gz | |
Change projects to poc and blog to log.
Diffstat (limited to '_site/blog/suckless-software/index.html')
| -rw-r--r-- | _site/blog/suckless-software/index.html | 141 |
1 files changed, 0 insertions, 141 deletions
diff --git a/_site/blog/suckless-software/index.html b/_site/blog/suckless-software/index.html deleted file mode 100644 index bab40c6..0000000 --- a/_site/blog/suckless-software/index.html +++ /dev/null @@ -1,141 +0,0 @@ -<!DOCTYPE html> -<html> - <head> - <meta charset="utf-8"> - <title>How I manage Suckless software installations</title> - - <head> - <meta charset="utf-8"> - <meta name="viewport" content="width=device-width, initial-scale=1"> - <title>How I manage Suckless software installations</title> - <link rel="stylesheet" href="/assets/css/main.css"> - <link rel="stylesheet" href="/assets/css/skeleton.css"> -</head> - - - - </head> - <body> - - <div id="nav-container" class="container"> - <ul id="navlist" class="left"> - - <li > - <a href="/" class="link-decor-none">hme</a> - </li> - <li class="active"> - <a href="/blog/" class="link-decor-none">blg</a> - </li> - <li > - <a href="/projects/" class="link-decor-none">poc</a> - </li> - <li > - <a href="/about/" class="link-decor-none">abt</a> - </li> - <li><a href="/feed.xml" class="link-decor-none">rss</a></li> - </ul> -</div> - - - - <main> - <div class="container"> - <div class="container-2"> - <h2 class="center" id="title">HOW I MANAGE SUCKLESS SOFTWARE INSTALLATIONS</h2> - <h6 class="center">30 NOVEMBER 2025</h5> - <br> - <div class="twocol justify"><p>Since <a href="https://suckless.org/" class="external" target="_blank" rel="noopener noreferrer">suckless</a> software requires users to modify the -source code and recompile to customize, I need a way to maintain patches over -the long term while retaining the ability to upgrade the software as new -versions are released.</p> - -<h2 id="initial-setup">Initial setup</h2> - -<p>When using a suckless program, I usually begin by cloning the project and -setting the remote push URL to my own git repository:</p> - -<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>git clone git://git.suckless.org/dwm -git reset --hard <tag> -git remote set-url --push origin git@git.asciimx.com:/repos/dwm -</code></pre></div></div> - -<p>This way, I can pull updates from the upstream project whenever I want, while -committing my changes to my git repository. The git reset command aligns my -branch head with a stable release before applying patches or installing the -software.</p> - -<p>If all I want to do is reconfigure the software (e.g., change key bindings), -which is what I need most of the time, the recommended approach is to modify -the config.h file. If the config.h isn’t yet in the project, the -<code class="language-plaintext highlighter-rouge">make clean <target></code> command will generate it from the defaults and compile -the software. The <code class="language-plaintext highlighter-rouge"><target></code> is the name of the application (e.g., dwm) found -in the Makefile. I modify the resulting config.h file and run <code class="language-plaintext highlighter-rouge">make clean -install</code> to install the software before committing and pushing my changes to -the git repo.</p> - -<h2 id="dwm-and-slstatus">dwm and slstatus</h2> - -<p>Since dwm and slstatus are always running, <code class="language-plaintext highlighter-rouge">make install</code> will likely fail for -them. The operating system may prevent the installer from replacing running -executables with new ones. Hence, we must first stop the running instances of -these programs (in my case, using Mod + Shift + q). Then, switch to a tty -(Ctrl + Alt + F1), log in, and change the directory to where dwm/slstatus is. -We can run <code class="language-plaintext highlighter-rouge">make install</code> to install the software and switch back to the -graphical session (Ctrl + Alt + F5).</p> - -<p>The key combinations for switching to the tty and back may differ across -systems. The ones listed above are for OpenBSD.</p> - -<h2 id="subsequent-upgrades">Subsequent upgrades</h2> - -<p>When suckless releases a new version, I run <code class="language-plaintext highlighter-rouge">git pull --rebase</code> to fetch the -upstream changes and rebase my patches on top of them. Because I tend to use -stable versions, I perform another interactive rebase to drop the commits -between the latest stable version tag and my patch before installing the -software.</p> - -<p>Commit log before upgrading:</p> - -<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>dt236 My patch. -3fkdf Version 6.5. -</code></pre></div></div> - -<p>Commit log after pulling:</p> - -<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>w467d My patch. -gh25g A commit. -g525g Another commit. -3fkdf Version 6.6. -vd425 Old commit. -q12vu Another old commit. -3fkdf Version 6.5. -</code></pre></div></div> - -<p>Commit log after the interactive rebase:</p> - -<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>h57jh My patch. -3fkdf Version 6.6. -vd425 Old commit. -q12vu Another old commit. -3fkdf Version 6.5. -</code></pre></div></div> - -<p>And finally, I commit and push all the changes to my git repository.</p> - -</div> - <p class="post-author right">by W. D. Sadeep Madurange</p> - </div> - </div> - </main> - - <div class="footer"> - <div class="container"> - <div class="twelve columns right container-2"> - <p id="footer-text">© ASCIIMX - 2025</p> - </div> - </div> -</div> - - - </body> -</html> |