Prefer pod2html over groff to create sieveshell.1.html from sieveshell.pl / sieveshell.1

Дилян Палаузов dilyan.palauzov at aegee.org
Fri May 4 06:53:57 EDT 2012


Hello,

the file doc/man/sieveshell.1.html is created with

doc/man/sieveshell.1.html: $(top_srcdir)/perl/sieve/scripts/sieveshell.pl
         pod2html $(top_srcdir)/perl/sieve/scripts/sieveshell.pl > $@

man/sieveshell.1 is created with
         pod2man $(top_srcdir)/perl/sieve/scripts/sieveshell.pl > $@

and all other doc/man/ files are created with

   for man in $(top_builddir)/man/*.[1-9] $(top_srcdir)/man/*.[1-9]; \
     do \
        groff -man -Thtml $$man > doc/man/`basename $$man`.html; \
     done
   rm -f doc/groff-html-*.png

Is there any reason to prefer
     pod2html $(top_srcdir)/perl/sieve/scripts/sieveshell.pl > 
doc/man/sieveshell.1.html
over
     groff -man -Thtml $(top_srcdir)/man/sieveshell.1 > 
doc/man/sieveshell.1.html
and can the special rule for sieveshell.1.html be deleted?

The same question applies to (doc/)man/cyradm.1(.html), with the remark, 
that man/cyradm.1 is not created, only doc/man/cyradm.1.html . (Shall it 
stay this way?)

Със здраве
   Дилян


More information about the Cyrus-devel mailing list