<feed xmlns='http://www.w3.org/2005/Atom'>
<title>xavi/kristall/doc, branch master</title>
<subtitle>A Gemini client written in C++/Qt.
</subtitle>
<id>https://gitea.privatedns.org/xavi/kristall/atom?h=master</id>
<link rel='self' href='https://gitea.privatedns.org/xavi/kristall/atom?h=master'/>
<link rel='alternate' type='text/html' href='https://gitea.privatedns.org/xavi/kristall/'/>
<updated>2023-06-10T07:11:50+00:00</updated>
<entry>
<title>doc/gen-man.sh: use printf instead of echo to make it portable</title>
<updated>2023-06-10T07:11:50+00:00</updated>
<author>
<name>Carlos Henrique Lima Melara</name>
<email>charlesmelara@riseup.net</email>
</author>
<published>2023-06-10T00:23:52+00:00</published>
<link rel='alternate' type='text/html' href='https://gitea.privatedns.org/xavi/kristall/commit/?id=4308819b9df8101bebc4c971f2de29c4cfc376df'/>
<id>urn:sha1:4308819b9df8101bebc4c971f2de29c4cfc376df</id>
<content type='text'>
printf is recommended instead of echo because it has a more predictable
behavior than echo (tip from the POSIX standard ;-). Using it allow us
to generate the _same_ manpage using sh, dash or bash.
</content>
</entry>
<entry>
<title>doc: remove unused DATE logic from gen-man.sh</title>
<updated>2023-06-05T06:29:26+00:00</updated>
<author>
<name>Carlos Henrique Lima Melara</name>
<email>charlesmelara@riseup.net</email>
</author>
<published>2023-06-04T18:47:30+00:00</published>
<link rel='alternate' type='text/html' href='https://gitea.privatedns.org/xavi/kristall/commit/?id=b6c0259854878401199754374ab0890055d6db74'/>
<id>urn:sha1:b6c0259854878401199754374ab0890055d6db74</id>
<content type='text'>
The use of $DATE was removed in 7a5499d7, but I forgot to remove this
logic from gen-man.sh.
</content>
</entry>
<entry>
<title>doc: double escape special characters (\f) in gen-man.sh</title>
<updated>2023-06-05T06:29:26+00:00</updated>
<author>
<name>Carlos Henrique Lima Melara</name>
<email>charlesmelara@riseup.net</email>
</author>
<published>2023-06-02T01:05:05+00:00</published>
<link rel='alternate' type='text/html' href='https://gitea.privatedns.org/xavi/kristall/commit/?id=9c60513b8dc1aae5924b8ae667d1081838a284ff'/>
<id>urn:sha1:9c60513b8dc1aae5924b8ae667d1081838a284ff</id>
<content type='text'>
sh and, consequently, dash interpret some escaped characters as control
sequences, so an echo '\f' outputs a form feed. To avoid this problem
in manpage generation, we have to escape "\f" sequences.
</content>
</entry>
<entry>
<title>Removes build date from manpage to make kristall builds reproducible</title>
<updated>2022-01-30T15:55:41+00:00</updated>
<author>
<name>Carlos Henrique Lima Melara</name>
<email>charlesmelara@outlook.com</email>
</author>
<published>2022-01-30T14:54:03+00:00</published>
<link rel='alternate' type='text/html' href='https://gitea.privatedns.org/xavi/kristall/commit/?id=7a5499d7a264d48c398063988ff4d246a5063f42'/>
<id>urn:sha1:7a5499d7a264d48c398063988ff4d246a5063f42</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc/gen-man.sh: make sed command portable</title>
<updated>2021-09-05T09:04:54+00:00</updated>
<author>
<name>linear</name>
<email>dev@linear.network</email>
</author>
<published>2021-09-05T07:34:07+00:00</published>
<link rel='alternate' type='text/html' href='https://gitea.privatedns.org/xavi/kristall/commit/?id=2cdf23f692ae9050f1f109162aeac82d37643748'/>
<id>urn:sha1:2cdf23f692ae9050f1f109162aeac82d37643748</id>
<content type='text'>
usage of the "-i" feature of sed is not entirely portable across
different operating systems. -i has an optional extension to save
a backup of the edited file, and different systems parse this option
in a different manner.

the sed in GNU, busybox, NetBSD, and OpenBSD expects the argument
to be immediately after, like `-i.bak`, if it is present.

the sed in macOS and FreeBSD expects the argument to follow after
a space, like `-i .bak`, but will accept the `-i.bak` form as well.

the issue is that when no backup is specified, the first requires
just `-i`, where the second requires `-i ''`. the easiest way around
this is to just add a backup, which is what i chose to do here. i
also added the .bak extension to the .gitignore.

additionally, all aforementioned seds except for GNU require the file
to be the final argument, and will not accept it between other options.
</content>
</entry>
<entry>
<title>doc/gen-man.sh: head and tail +/- syntax is not portable</title>
<updated>2021-09-05T09:04:23+00:00</updated>
<author>
<name>linear</name>
<email>dev@linear.network</email>
</author>
<published>2021-09-05T08:03:36+00:00</published>
<link rel='alternate' type='text/html' href='https://gitea.privatedns.org/xavi/kristall/commit/?id=e07c8eb599c9fc0f77c7a6f0643a786b751796b4'/>
<id>urn:sha1:e07c8eb599c9fc0f77c7a6f0643a786b751796b4</id>
<content type='text'>
the + and - syntax on head and tail are only present, as far as i know,
in GNU coreutils, and are not present on any other UNIX or BSD systems.

this patch replaces those with a more portable processing chain, which
is tested to work on GNU coreutils, NetBSD, macOS, and busybox.
</content>
</entry>
<entry>
<title>don't depend on bash</title>
<updated>2021-04-03T08:47:53+00:00</updated>
<author>
<name>omni</name>
<email>omni+vagant@hack.org</email>
</author>
<published>2021-04-03T00:57:02+00:00</published>
<link rel='alternate' type='text/html' href='https://gitea.privatedns.org/xavi/kristall/commit/?id=8d0eb55033a46f5b278224d173499d2f3d42eadf'/>
<id>urn:sha1:8d0eb55033a46f5b278224d173499d2f3d42eadf</id>
<content type='text'>
</content>
</entry>
<entry>
<title>make gem-to-man.awk portable</title>
<updated>2021-04-03T08:47:29+00:00</updated>
<author>
<name>omni</name>
<email>omni+vagant@hack.org</email>
</author>
<published>2021-04-03T01:03:01+00:00</published>
<link rel='alternate' type='text/html' href='https://gitea.privatedns.org/xavi/kristall/commit/?id=5c59e94d941531a099d097d11bfc31274a932229'/>
<id>urn:sha1:5c59e94d941531a099d097d11bfc31274a932229</id>
<content type='text'>
</content>
</entry>
<entry>
<title>man: fix date</title>
<updated>2021-03-15T09:38:53+00:00</updated>
<author>
<name>Mike Skec</name>
<email>skec@protonmail.ch</email>
</author>
<published>2021-03-15T09:14:12+00:00</published>
<link rel='alternate' type='text/html' href='https://gitea.privatedns.org/xavi/kristall/commit/?id=aab2b50efa1298ba8a5dd1f21f05c306ee8ea4d1'/>
<id>urn:sha1:aab2b50efa1298ba8a5dd1f21f05c306ee8ea4d1</id>
<content type='text'>
The month in the date was set to the 'minute' that the help file was last modified
</content>
</entry>
<entry>
<title>man: make mention of -w and -i options</title>
<updated>2021-03-06T22:41:41+00:00</updated>
<author>
<name>Mike Skec</name>
<email>skec@protonmail.ch</email>
</author>
<published>2021-03-06T22:23:58+00:00</published>
<link rel='alternate' type='text/html' href='https://gitea.privatedns.org/xavi/kristall/commit/?id=547e7b1ad458db826622ff7bf944b94a0f8b9065'/>
<id>urn:sha1:547e7b1ad458db826622ff7bf944b94a0f8b9065</id>
<content type='text'>
</content>
</entry>
</feed>
