diff options
| author | Jean-Sébastien Pédron <jean-sebastien@rabbitmq.com> | 2017-04-25 10:50:00 +0200 |
|---|---|---|
| committer | Jean-Sébastien Pédron <jean-sebastien@rabbitmq.com> | 2017-04-26 18:24:27 +0200 |
| commit | c0af14ba3b98d4e028274fa326144223cb508b5c (patch) | |
| tree | 528e2231c4ccd80a10be3da79485e8e385b216e7 /.gitignore | |
| parent | 775a41579c6ed5dd046aaed0eb5eacf8a48460f7 (diff) | |
| download | rabbitmq-server-git-c0af14ba3b98d4e028274fa326144223cb508b5c.tar.gz | |
docs: Convert manpages from DocBook to mdoc(7)
Writing those manpages directly in the target markup language allows to
use its full expressiveness, unlike the generated output from DocBook.
To create their HTML versions, we use mandoc(1), plus a small awk script
to adapt the generated HTML to our needs. I tried groff(1) and
man2html(1) but the former transforms nearly everything to simple <p>
and the later tries to reproduce the rendering of a manpage in a
terminal.
Manpages in section 1 are moved to section 8 because they are commands
to manage a system service, not general purpose commands.
This commits requires a change in the website to integrate the new
generated HTML manpages.
[#143563295]
Diffstat (limited to '.gitignore')
| -rw-r--r-- | .gitignore | 16 |
1 files changed, 1 insertions, 15 deletions
diff --git a/.gitignore b/.gitignore index d88b753142..1618d6b5fe 100644 --- a/.gitignore +++ b/.gitignore @@ -19,22 +19,8 @@ /escript rabbit.d -# Generated sources files. -src/rabbit_ctl_usage.erl -src/rabbit_plugins_usage.erl - # Generated documentation. -docs/rabbitmq-echopid.man.xml -docs/rabbitmq-env.conf.5 -docs/rabbitmq-env.conf.5.man.xml -docs/rabbitmq-plugins.1 -docs/rabbitmq-plugins.1.man.xml -docs/rabbitmq-server.1 -docs/rabbitmq-server.1.man.xml -docs/rabbitmq-service.man.xml -docs/rabbitmqctl.1 -docs/rabbitmqctl.1.man.xml -docs/*.tmp +docs/*.html # Dialyzer *.plt |