<feed xmlns='http://www.w3.org/2005/Atom'>
<title>coreutils/man/help2man, branch v9.3</title>
<subtitle>Mirror of https://https.git.savannah.gnu.org/git/coreutils.git/
</subtitle>
<id>https://git.shady.money/coreutils/atom?h=v9.3</id>
<link rel='self' href='https://git.shady.money/coreutils/atom?h=v9.3'/>
<link rel='alternate' type='text/html' href='https://git.shady.money/coreutils/'/>
<updated>2022-02-15T17:07:22Z</updated>
<entry>
<title>doc: use bold style for man page references</title>
<updated>2022-02-15T17:07:22Z</updated>
<author>
<name>Pádraig Brady</name>
<email>P@draigBrady.com</email>
</author>
<published>2022-02-14T21:36:29Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/coreutils/commit/?id=63228501e68875cc072bf479d491ec39ffa01ba3'/>
<id>urn:sha1:63228501e68875cc072bf479d491ec39ffa01ba3</id>
<content type='text'>
It's more common to use bold style than not,
for references to other man pages.
Ideally each man page renderer would highlight references,
but currently some rely on styles in the page itself.

* man/help2man: Implement a --bold-refs option that
will mark up references like "name(1)" with bold
style around the "name" component.
* man/local.mk: Pass --bold-refs to our help2man unless disabled.
* configure.ac: Add a --disable-bold-man-page-references option.
Addresses https://bugs.gnu.org/53977
</content>
</entry>
<entry>
<title>maint: sync help2man to latest version</title>
<updated>2021-09-16T14:03:23Z</updated>
<author>
<name>Pádraig Brady</name>
<email>P@draigBrady.com</email>
</author>
<published>2021-09-16T14:03:23Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/coreutils/commit/?id=cca434a4a5e7921116ac0f8ace48457a03ebbf1b'/>
<id>urn:sha1:cca434a4a5e7921116ac0f8ace48457a03ebbf1b</id>
<content type='text'>
* man/help2man: sync to changes from version 1.48.5.
Note this doesn't materially change the generated man pages.
</content>
</entry>
<entry>
<title>maint: sync help2man to latest version</title>
<updated>2020-10-25T13:31:37Z</updated>
<author>
<name>Pádraig Brady</name>
<email>P@draigBrady.com</email>
</author>
<published>2020-10-25T13:10:32Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/coreutils/commit/?id=f803c0e92d7c2e1563dfaa34a91fd739bb3e40ed'/>
<id>urn:sha1:f803c0e92d7c2e1563dfaa34a91fd739bb3e40ed</id>
<content type='text'>
* man/help2man: sync to changes from version 1.47.16.
Note this doesn't materially change the generated man pages.
Addresses https://bugs.gnu.org/44105
</content>
</entry>
<entry>
<title>build: reinstate distribution of man pages</title>
<updated>2017-10-02T00:32:48Z</updated>
<author>
<name>Pádraig Brady</name>
<email>P@draigBrady.com</email>
</author>
<published>2017-10-01T00:08:02Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/coreutils/commit/?id=856b828320649d941097a89dbb8c5343760ddad0'/>
<id>urn:sha1:856b828320649d941097a89dbb8c5343760ddad0</id>
<content type='text'>
man pages change little between systems,
so falling back to distributed pages make sense
when cross compiling or lacking perl.

* man/local.mk: Add all man pages to EXTRA_DIST
so that they're distributed in the generated tarball.
Use the dummy-man page generator if cross compiling.
Set TZ to avoid a distcheck failure where man pages
used a diffent month than those rebuilt (with a .timestamp).
* man/dummy-man: Only fall back to generating a stub
if copying an existing man page fails.
* man/help2man: Sync portable TZ=UTC0 specification
from upstream help2man.
* NEWS: Mention the build-related change.
Fixes https://bugs.gnu.org/28574
</content>
</entry>
<entry>
<title>all: prefer HTTPS in URLs</title>
<updated>2017-09-19T08:22:54Z</updated>
<author>
<name>Paul Eggert</name>
<email>eggert@cs.ucla.edu</email>
</author>
<published>2017-09-19T08:13:23Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/coreutils/commit/?id=be87d61299f52e366bcb65fd176ccf325b0f77e0'/>
<id>urn:sha1:be87d61299f52e366bcb65fd176ccf325b0f77e0</id>
<content type='text'>
</content>
</entry>
<entry>
<title>maint: modernize URLs</title>
<updated>2017-01-15T07:59:01Z</updated>
<author>
<name>Paul Eggert</name>
<email>eggert@cs.ucla.edu</email>
</author>
<published>2017-01-15T06:57:51Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/coreutils/commit/?id=103d2b92da4bd5582dc598690458b07612ec846c'/>
<id>urn:sha1:103d2b92da4bd5582dc598690458b07612ec846c</id>
<content type='text'>
A lot of this is converting http: to https:.
Also, gmane went away, so remove URLs that no longer work and
are not easy to figure out what they were.
Some of this stuff is so old that it no longer matters anyway.
</content>
</entry>
<entry>
<title>doc: update to latest help2man</title>
<updated>2015-11-27T11:42:53Z</updated>
<author>
<name>Pádraig Brady</name>
<email>P@draigBrady.com</email>
</author>
<published>2015-11-27T11:13:06Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/coreutils/commit/?id=93e83ff52f3af65023f7a95fb0f79e660603ebe3'/>
<id>urn:sha1:93e83ff52f3af65023f7a95fb0f79e660603ebe3</id>
<content type='text'>
Sync with version 1.47.3 which provides these significant changes:

- support for reproducible builds by using $SOURCE_DATE_EPOCH.
- Adjust spacing of italic text at roman/italic boundaries.
</content>
</entry>
<entry>
<title>doc: reference online info pages directly from man pages</title>
<updated>2014-09-11T09:53:06Z</updated>
<author>
<name>Pádraig Brady</name>
<email>P@draigBrady.com</email>
</author>
<published>2014-09-10T10:53:50Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/coreutils/commit/?id=e8715100cb2824fbd8ec724728a21fffdbcdb9f5'/>
<id>urn:sha1:e8715100cb2824fbd8ec724728a21fffdbcdb9f5</id>
<content type='text'>
* src/system.h (emit_ancillary_info): Add a direct reference
to the corresponding online info documentation.  Corresponding
redirects were put in place on www.gnu.org to allow for concise links.
* help2man: Adjust to add the "online help" link (and subsequent
translation bugs link) to a "REPORTING BUGS" section.
Also add the concise links for further information in --help
to the "SEE ALSO" section, and dispense with the more verbose
default for that.
</content>
</entry>
<entry>
<title>maint: avoid patching help2man</title>
<updated>2013-09-12T06:02:22Z</updated>
<author>
<name>Bernhard Voelker</name>
<email>mail@bernhard-voelker.de</email>
</author>
<published>2013-09-11T22:02:33Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/coreutils/commit/?id=b3578fc9ffe70b9466687f9f6470a85f1a0ab14f'/>
<id>urn:sha1:b3578fc9ffe70b9466687f9f6470a85f1a0ab14f</id>
<content type='text'>
Commit cde1ea0e separated the coreutils-specific patches from help2man.
Most changes had been made to accommodate to the coreutils style guide,
i.e., to avoid syntax-check failures like sc_long_lines.
Yet 2 changes had to be put into the patch help2man.diff.
But this added the dependency to patch(1) in distribution builds.
Incidentally, the 2 remaining parts of the patch can easily be
done outside of help2man.  Therefore, this commit partly reverts
the recent separation of help2man into 'help2man.in' and
'help2man.diff', and instead uses the original help2man script.

* man/help2man.in: Rename to ...
* man/help2man: ... this file.
* man/help2man.diff: Remove.
* man/local.mk (mandeps): Remove man/help2man.
(man/help2man): Remove recipe.
(.x.1): Add the --info-page option when calling help2man in order
to change the name of the texinfo manual from the default, "info PRG",
to "info coreutils 'PRG invocation'".
Furthermore, use an sed pattern to remove the sentence starting
with "For complete documentation".
* .gitignore (/man/help2man): Remove entry.
* .x-update-copyright: Replace the entries for the files
'man/help2man.diff' and 'man/help2man.in' by 'man/help2man'.
* cfg.mk (sc_long_lines): Instead of 'man/help2man.in', exempt
'man/help2man' from this test.
(sc_po_check): Likewise.
(sc_space_tab): Instead of 'man/help2man.diff', exempt 'man/help2man'
from this test.
(sc_trailing_blank): Likewise.
(sc_prohibit_tab_based_indentation): Instead of 'man/help2man.in' and
'man/help2man.diff', exempt 'man/help2man'.
* man/dummy-man: Recognize the option --info-page=... as no-op.
</content>
</entry>
<entry>
<title>maint: update help2man to 1.43.3</title>
<updated>2013-09-09T20:52:18Z</updated>
<author>
<name>Bernhard Voelker</name>
<email>mail@bernhard-voelker.de</email>
</author>
<published>2013-08-02T06:28:50Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/coreutils/commit/?id=54a155a37ea2736671bbbf5bf45446425314a77a'/>
<id>urn:sha1:54a155a37ea2736671bbbf5bf45446425314a77a</id>
<content type='text'>
Instead of diverging further from the upstream GNU help2man project
(http://www.gnu.org/software/help2man/), hold a copy of the original
script and keep track of our changes in a separate patch file.

The man pages created with the new version show the following,
non-invasive differences:
a) command options in the EXAMPLE sections are no longer in bold format,
b) file names are underlined now consistently.

* man/help2man: Rename to ...
* man/help2man.in: ... this file, and update content from the
upstream GNU help2man project.
* man/help2man.diff: Add patch file for help2man to remove the
sentence "For complete documentation ..." (see commit 5d4f09d8),
and to emit "info coreutils 'PROG invocation'" into the man
pages (77abf69a).
* man/local.mk (mandeps): Add help2man to the dependencies of
the man pages.
(man/help2man): Add rule to generate this script from the upstream
help2man.in file and the help2man.diff patch.
* .gitignore: Add man/help2man as it is no longer version controlled.
* cfg.mk (sc_long_lines): Exempt help2man.in from this check.
(sc_po_check): Likewise.
(sc_space_tab): Likewise.
(sc_trailing_blank): Exempt man/help2man.diff from this check.
(sc_prohibit_tab_based_indentation): Instead of help2man, now exempt
both help2man.in and help2man.diff from this test.
* .x-update-copyright: Add new file and add the above new help2man
files as well as the COPYING file.
</content>
</entry>
</feed>
