<feed xmlns='http://www.w3.org/2005/Atom'>
<title>xavi/kristall/doc/gen-man.sh, 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>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>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>help.gemini: add spaces after headers</title>
<updated>2021-03-02T09:55:50+00:00</updated>
<author>
<name>Mike Skec</name>
<email>skec@protonmail.ch</email>
</author>
<published>2021-03-02T05:09:30+00:00</published>
<link rel='alternate' type='text/html' href='https://gitea.privatedns.org/xavi/kristall/commit/?id=22759e719d5561ed0dbfd0e45a52a13994699ee3'/>
<id>urn:sha1:22759e719d5561ed0dbfd0e45a52a13994699ee3</id>
<content type='text'>
It seems common in gemtext to have a line of spacing after headings. helps with readability a bit
</content>
</entry>
<entry>
<title>Add awk script for gemtext to man conversion</title>
<updated>2021-03-02T09:55:50+00:00</updated>
<author>
<name>Mike Skec</name>
<email>skec@protonmail.ch</email>
</author>
<published>2021-02-27T05:42:54+00:00</published>
<link rel='alternate' type='text/html' href='https://gitea.privatedns.org/xavi/kristall/commit/?id=7644e39d6559733fde244d1fef053f9f56b393ce'/>
<id>urn:sha1:7644e39d6559733fde244d1fef053f9f56b393ce</id>
<content type='text'>
</content>
</entry>
<entry>
<title>Man page generation script added</title>
<updated>2021-03-02T09:55:50+00:00</updated>
<author>
<name>Mike Skec</name>
<email>skec@protonmail.ch</email>
</author>
<published>2021-02-24T11:08:46+00:00</published>
<link rel='alternate' type='text/html' href='https://gitea.privatedns.org/xavi/kristall/commit/?id=333332ac295e0af3d8d394fa01619fec66288620'/>
<id>urn:sha1:333332ac295e0af3d8d394fa01619fec66288620</id>
<content type='text'>
Not yet added to make target. ^Cy also need some improving.
</content>
</entry>
</feed>
