#36 Alternative manpage formats - text/html

open
nobody
None
5
2004-06-04
2004-06-04
No

The basic make commands used are:

%.txt: %.1
nroff -man < $< > $@

%.html: %.1
man2html < $< | grep -v '^Content-type:' | grep -v
'^Time:' > $@

But I added some Perl to clean it up...

Discussion

  • Stefan Weyergraf

    Logged In: YES
    user_id=3434

    What happens is someone doesn't have perl? It doesn't
    compile then??

     
  • Anders F Björklund

    Logged In: YES
    user_id=5895

    What do you mean, "not have perl" ? ;-)

    Suppose you could stick a minus sign
    in front of those commands to make
    them croak less when running them...

    You need groff and man-utils, as well
    (for the nroff and man2html commands)

     
  • Stefan Weyergraf

    Logged In: YES
    user_id=3434

    anyway. It should be if anyone doesn't have perl, nroff or
    man2html since the generated files will be contained in the
    source distro.

     
  • Stefan Weyergraf

    Logged In: YES
    user_id=3434

    Hm. The ppc.txt still contains escape seqs. And it's
    certainly not the right thing to use perl to filter such
    things out :-(
    And actually I'm against the groff format as documentation
    source. What can we use these days? Maybe some kind of TeX,
    like Texi? Or SGML?

     
  • Anders F Björklund

    Logged In: YES
    user_id=5895

    This was just a manpage... I offered some other formats for
    Windows users (built using Linux, or at least the GNU
    software components)

    There are probably lots of other documentation that should
    go in the doc/ folder. I hear that "DocBook" is a rather
    popular format. (XML/SGML)

    On the other hand, text is a nice format too... Use the wiki
    perhaps ?

     

Log in to post a comment.

Get latest updates about Open Source Projects, Conferences and News.

Sign up for the SourceForge newsletter:





No, thanks