Re: Missing man pages



Heya,

Go look in the Debian packages. The Debian policy requires man pages for
files in bin/, so quite a few man pages have been written already.

Could the Debian maintainers for the mentioned packages put their man
pages in bugzilla, so they get upstream ?

BTW, I think most of the GNOME programs could have the same man page, as
they don't add a single new command-line parameter over the default
Gnome ones. For example, all the games could have the same man page.

Cheers


On Thu, 2002-07-18 at 16:18, Brian Cameron wrote:
> 
> Gnome Developers:
> 
> Sun requires that all binaries in /bin and /libexec have man pages,
> so I am in the process of working towards that end. 
> 
> I have gone through all the Gnome binaries and catalogued which 
> binaries do not have man pages.  Some maintainers may have just
> overlooked these missing man pages, so this email might hopefully
> point them towards filling in the blanks.  I expect that Sun will
> also help with this effort of filling in the blanks, but it will
> probably be a week or so before we get to the point where we are
> helping.  I suspect that Sun might have to rewrite or massage
> the man pages to get them into a Sun look & feel, so I need to
> get a handle on that before we are ready to start helping to
> contribute generating man pages.
>  
> Below the packages are broken down between user and developer
> programs.  This is because man pages for user programs is a higher
> priority for Sun.  I would appreciate any comments if anybody feels
> that I've placed a "user" program under "developer" or vice versa.
> I suspect that these comments wouldn't be of general interest, so
> please send any such comments to me only.
> 
> Thanks!
> 
> Brian
> 
> --info follows--
> 
> Missing Man Pages
> -----------------
> 
> By package, this is how many binaries are missing man pages:
> 
> 17 gnome-games
> 13 gnome-control-center
> 12 scrollkeeper
>  9 ghostscript
>  7 intltool
>  6 metacity
>  4 bonobo-activation
>  4 gnome-panel
>  4 gnome-media
>  4 ORBit2
>  3 gconf
>  3 yelp
>  3 gtk+
>  3 libgnome
>  3 audiofile
>  2 linc
>  2 glib
>  2 printman
>  2 gnome-session
>  1 gnome-common
>  1 libxslt
>  1 libIDL
>  1 libart_lgpl
>  1 eog
>  1 gconf-editor
>  1 ggv
>  1 ghex
>  1 gnome-applets
>  1 glade
>  1 profterm
>  1 gperfmeter
>  1 gedit
>  1 nautilus
>  1 system-details
>  1 libbonoboui
>  1 pango
>  1 at-spi
>  1 libgnomeprint
> 
> Note: module name is listed in parens for those binaries that are
>       missing man pages.
> 
> User Packages - Missing man Page
> --------------------------------
> 
> man/man1/activation-client.1 (bonobo-activation)
> man/man1/bdftops.1 (ghostscript)
> man/man1/bonobo-activation-sysconf.1 (bonobo-activation)
> man/man1/bonobo-slay.1 (bonobo-activation)
> man/man1/cddb-slave2-properties.1 (gnome-media)
> man/man1/eog.1 (eog)
> man/man1/fixmswrd.pl.1 (ghostscript)
> man/man1/freecell.1 (gnome-games)
> man/man1/gataxx.1 (gnome-games)
> man/man1/gconf-editor.1 (gconf-editor)
> man/man1/gconftool-2.1 (gconf)
> man/man1/ggv.1 (ggv)
> man/man1/ghex2.1 (ghex)
> man/man1/gkb_xmmap.1 (gnome-applets)
> man/man1/glade-2.1 (glade)
> man/man1/glib-gettextize.1 (glib)
> man/man1/glines.1 (gnome-games)
> man/man1/gnect.1 (gnome-games)
> man/man1/gnibbles.1 (gnome-games)
> man/man1/gnobots2.1 (gnome-games)
> man/man1/gnome-accessibility-keyboard-properties.1 (gnome-control-center)
> man/man1/gnome-background-properties.1 (gnome-control-center)
> man/man1/gnome-cd.1 (gnome-media)
> man/man1/gnome-control-center.1 (gnome-control-center)
> man/man1/gnome-default-applications-properties.1 (gnome-control-center)
> man/man1/gnome-desktop-item-edit.1 (gnome-panel)
> man/man1/gnome-file-types-properties.1 (gnome-control-center)
> man/man1/gnome-font-properties.1 (gnome-control-center)
> man/man1/gnome-help.1 (yelp)
> man/man1/gnome-keybinding-properties.1 (gnome-control-center)
> man/man1/gnome-keyboard-properties.1 (gnome-control-center)
> man/man1/gnome-mouse-properties.1 (gnome-control-center)
> man/man1/gnome-network-preferences.1 (gnome-control-center)
> man/man1/gnome-panel-preferences.1 (gnome-panel)
> man/man1/gnome-panel-screenshot.1 (gnome-panel)
> man/man1/gnome-print-manager.1 (printman)
> man/man1/gnome-session-properties.1 (gnome-session)
> man/man1/gnome-session-save.1 (gnome-session)
> man/man1/gnome-sound-properties.1 (control-center)
> man/man1/gnome-sound-recorder.1 (gnome-media)
> man/man1/gnome-stones.1 (gnome-games)
> man/man1/gnome-terminal.1 (profterm)
> man/man1/gnome-text-editor.1 (gedit)
> man/man1/gnome-theme-properties.1 (gnome-control-center)
> man/man1/gnome-ui-properties.1 (gnome-control-center)
> man/man1/gnometris.1 (gnome-games)
> man/man1/gnomine.1 (gnome-games)
> man/man1/gnotravex.1 (gnome-games)
> man/man1/gnotski.1 (gnome-games)
> man/man1/gobject-query.1 (glib)
> man/man1/gperfmeter.1 (gperfmeter)
> man/man1/gtali.1 (gnome-games)
> man/man1/gtk-demo.1 (gtk+)
> man/man1/gtk-query-immodules-2.0.1 (gtk+)
> man/man1/iagno.1 (gnome-games)
> man/man1/linc-cleanup-sockets.1 (linc)
> man/man1/lprsetup.sh.1 (ghostscript)
> man/man1/mahjongg.1 (gnome-games)
> man/man1/metacity-properties.1 (metacity)
> man/man1/metacity-theme-viewer.1 (metacity)
> man/man1/metacity.1 (metacity)
> man/man1/nautilus.1 (nautilus)
> man/man1/panel-test-applets.1 (gnome-panel)
> man/man1/pj-gs.sh.1 (ghostscript)
> man/man1/ps2pdf14.1 (ghostscript)
> man/man1/pv.sh.1 (ghostscript)
> man/man1/same-gnome.1 (gnome-games)
> man/man1/scrollkeeper-get-cl.1 (scrollkeeper)
> man/man1/scrollkeeper-get-content-list.1 (scrollkeeper)
> man/man1/scrollkeeper-get-extended-content-list.1 (scrollkeeper)
> man/man1/scrollkeeper-get-index-from-docpath.1 (scrollkeeper)
> man/man1/scrollkeeper-get-toc-from-docpath.1 (scrollkeeper)
> man/man1/scrollkeeper-get-toc-from-id.1 (scrollkeeper)
> man/man1/scrollkeeper-install.1 (scrollkeeper)
> man/man1/scrollkeeper-rebuilddb.1 (scrollkeeper)
> man/man1/scrollkeeper-uninstall.1 (scrollkeeper)
> man/man1/scrollkeeper-update.1 (scrollkeeper)
> man/man1/system-details.1 (system-details)
> man/man1/sysvlp.sh.1 (ghostscript)
> man/man1/test-moniker.1 (libbonoboui)
> man/man1/typelib-dump.1 (ORBit2)
> man/man1/unix-lpr.sh.1 (ghostscript)
> man/man1/vumeter.1 (gnome-media)
> man/man1/wftopfa.1 (ghostscript)
> man/man1/yelp.1 (yelp)
> 
> libexec Executables Which Should Have man Pages
> -----------------------------------------------
> 
> man/man1/at-spi-registryd (at-spi)
> man/man1/gconf-sanity-check (gconf)
> man/man1/gconfd-2 (gconf)
> man/man1/gnome2-db2html (libgnome)
> man/man1/gnome2-info2html (libgnome)
> man/man1/gnome2-man2html (libgnome)
> man/man1/yelp-db2html (yelp)
> man/man1/gnome-print-manager-remote (printman)
> man/man1/metacity-dialog (metacity)
> 
> Developer Packages - Missing man Page
> -------------------------------------
> 
> man/man1/audiofile-config.1 (audiofile-historical)
> man/man1/bonobo-activation-run-query.1 (bonobo-activation)
> man/man1/gnome-autogen.sh.1 (gnome-common)
> man/man1/intltool-extract.1 (intltool)
> man/man1/intltool-merge.1 (intltool)
> man/man1/intltool-prepare.1 (intltool)
> man/man1/intltool-unicodify.1 (intltool)
> man/man1/intltool-update.1 (intltool)
> man/man1/intltoolize.1 (intltool)
> man/man1/libIDL-config-2.1 (libIDL)
> man/man1/libart2-config.1 (libart_lgpl)
> man/man1/ior-decode-2.1 (ORBit2)
> man/man1/libgnomeprint-2.0-font-install.1 (libgnomeprint)
> man/man1/linc-config.1 (linc)
> man/man1/metacity-message.1 (metacity)
> man/man1/metacity-window-demo.1 (metacity)
> man/man1/orbit-idl-2.1 (ORBit2)
> man/man1/orbit2-config.1 (ORBit2)
> man/man1/pango-querymodules.1 (pango)
> man/man1/scrollkeeper-extract.1 (scrollkeeper)
> man/man1/scrollkeeper-preinstall.1 (scrollkeeper)
> man/man1/sfconvert.1 (audiofile-historical)
> man/man1/sfinfo.1 (audiofile-historical)
> man/man1/xml-i18n-toolize.1 (intltool)
> man/man1/xslt-config.1 (libxslt)
> 
> User Packages - Has man Page
> ----------------------------
> 
> man/man1/esd
> man/man1/esdcat.1
> man/man1/esdctl.1
> man/man1/esdmon.1
> man/man1/esdplay.1
> man/man1/esdrec.1
> man/man1/esdsample.1
> man/man1/bonobo-activation-server.1
> man/man1/dvipdf.1
> man/man1/eps2eps.1
> man/man1/font2c.1
> man/man1/gdk-pixbuf-csource.1
> man/man1/gedit.1
> man/man1/glib-genmarshal.1
> man/man1/glib-mkenums.1
> man/man1/gnome-about.1
> man/man1/gnome-calculator.1
> man/man1/gnome-character-map.1
> man/man1/gnome-panel.1
> man/man1/gnome-search-tool.1
> man/man1/gnome-session.1
> man/man1/gnome-smproxy.1
> man/man1/gnome-system-log.1
> man/man1/gnome-wm.1
> man/man1/gs.1
> man/man1/gsbj.1
> man/man1/gsdj.1
> man/man1/gsdj500.1
> man/man1/gslj.1
> man/man1/gslp.1
> man/man1/gsnd.1
> man/man1/pdf2dsc.1
> man/man1/pdf2ps.1
> man/man1/pdfopt.1
> man/man1/pf2afm.1
> man/man1/pfbtopfa.1
> man/man1/play.1
> man/man1/printafm.1
> man/man1/ps2ascii.1
> man/man1/ps2epsi.1
> man/man1/ps2pdf.1
> man/man1/ps2pdf12.1
> man/man1/ps2pdf13.1
> man/man1/ps2pdfwr.1
> man/man1/ps2ps.1
> man/man1/rec.1
> man/man1/sox.1
> man/man1/soxmix.1
> 
> Developer Packages - Has man Page
> ---------------------------------
> 
> man/man1/esd-config.1
> man/man1/pkg-config.1
> man/man1/scrollkeeper-config.1
> man/man1/scrollkeeper-gen-seriesid.1
> man/man1/xml2-config.1
> 
> 
> 
> _______________________________________________
> gnome-hackers mailing list
> gnome-hackers gnome org
> http://mail.gnome.org/mailman/listinfo/gnome-hackers
-- 
/Bastien Nocera
http://hadess.net

Attachment: signature.asc
Description: This is a digitally signed message part



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]