fink-package-precedence man page
Max Horn <[email protected]>
| Newsgroups | gmane.os.apple.fink.core |
|---|---|
| Message-ID | <[email protected]> |
Hi Daniel, (CC: -core) just saw this in the IRC logs: [08:20:39] <dmacks> 'fink-package-precedence --help' is the only formal documentation. [08:21:06] <dmacks> It's mostly useful along side "lots of examples" to learn as you go and discuss with others. [08:21:44] * dmacks hates nroff, so I never wrote a real manpage:( Well, I would love a man page for fink-package-precedence -- and I also hate groff / troff / nroff... But good news: There are relatively easy ways to write man pages without touching *roff: 1) Use asciidoc. An example input file look like this: <http://www.methods.co.nz/asciidoc/asciidoc.1.txt>, see also <http://www.methods.co.nz/asciidoc/#_example_unix_man_pages>. Quite easy to use, if you install the asciidoc-a2x Fink package and then use a2x, like this: a2x -f manpage asciidoc.1.txt 1) Use DocBook directly (asciidoc goes via DocBook). This is much more verbose, but has the advantage of working on a semantic level, which I personally prefer. The doclifter package (which converts existing man pages to DocBook format...) has man pages built from DocBook. If you "fink fetch doclifter", and then look at the *xml files in the tarball, you'll get a good idea of how those pages look. Its Makefile also shows how to invoke xmlto to rebuild the .1 groff files from this. Perhaps you could write at least a minimalistic man page which explains the basic use? I know that I would greatly appreciate it! I would also rewriting the other Fink man pages with DocBook. Note that this would not introduce another boostrap dependency if we simply always committed the generate groff files along with the XML sources. Cheers, Max ------------------------------------------------------------------------------ Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ _______________________________________________ fink-core mailing list [email protected] List archive: http://news.gmane.org/gmane.os.apple.fink.core Subscription management: https://lists.sourceforge.net/lists/listinfo/fink-core