This file documents WoMan: A program to browse Unix manual pages `W.O.
(without) man'.
-Copyright @copyright{} 2001--2012 Free Software Foundation, Inc.
+Copyright @copyright{} 2001--2013 Free Software Foundation, Inc.
@quotation
Permission is granted to copy, distribute and/or modify this document
@ifnottex
@node Top
-@comment node-name, next, previous, up
@top WoMan: Browse Unix Manual Pages ``W.O. (without) Man''
@display
As distributed with Emacs @value{EMACSVER}.
+@ifnothtml
@email{F.J.Wright@@qmw.ac.uk, Francis J. Wright}
+@end ifnothtml
+@ifhtml
+Francis J. Wright
+@end ifhtml
@uref{http://centaur.maths.qmw.ac.uk/, School of Mathematical Sciences}
Queen Mary and Westfield College (University of London)
Mile End Road, London E1 4NS, UK
@c ===================================================================
@node Introduction
-@comment node-name, next, previous, up
@chapter Introduction
@cindex introduction
Microsoft Windows, but has also been tested on MS-DOS, and various
versions of UNIX and GNU/Linux.
-WoMan is distributed with GNU Emacs. In addition, the current source
-code and documentation files are available from
-@uref{http://centaur.maths.qmw.ac.uk/Emacs/WoMan/, the WoMan web
-server}.
+WoMan is distributed with GNU Emacs.
WoMan implements a subset of the formatting performed by the Emacs
@code{man} (or @code{manual-entry}) command to format a Unix-style
either running the command @code{woman-mini-help} or selecting the WoMan
menu option @samp{Mini Help}.
-WoMan is (of course) still under development! Please
-@email{F.J.Wright@@qmw.ac.uk, let me know} what doesn't work---I am
-adding and improving functionality as testing shows that it is
-necessary. Guidance on reporting bugs is given below. @xref{Bugs, ,
-Reporting Bugs}.
+Guidance on reporting bugs is given below. @xref{Bugs, , Reporting Bugs}.
@c ===================================================================
@node Background
-@comment node-name, next, previous, up
@chapter Background
@cindex background
and man can happily co-exist, which is very useful for comparison and
debugging purposes.
+@ignore
@code{nroff} simulates non-@acronym{ASCII} characters by using one or more
@acronym{ASCII} characters. WoMan should be able to do much better than
this. I have recently begun to add support for WoMan to use more of the
be possible to move WoMan from an emulation of @code{nroff} to an
emulation of @code{troff} as GNU Emacs moves to providing bit-mapped
display facilities.
+@end ignore
@node Finding
-@comment node-name, next, previous, up
@chapter Finding and Formatting Man Pages
@cindex using, finding man pages
@cindex using, formatting man pages
@end menu
@node Topic
-@comment node-name, next, previous, up
@section Topic Interface
@cindex topic interface
@end menu
@node Cache
-@comment node-name, next, previous, up
@subsection The WoMan Topic Cache
@cindex topic cache
@cindex cache, topic
@node Word at point
-@comment node-name, next, previous, up
@subsection Using the "Word at Point" as a Topic Suggestion
@cindex word at point
@cindex point, word at
@node Filename
-@comment node-name, next, previous, up
@section Filename Interface
@cindex filename interface
@node Automatic
-@comment node-name, next, previous, up
@section Automatic Interface
@cindex automatic interface
@c ===================================================================
@node Browsing
-@comment node-name, next, previous, up
@chapter Browsing Man Pages
@cindex using, browsing man pages
@cindex browsing man pages
@end menu
@node Fonts
-@comment node-name, next, previous, up
@section Fonts and Faces
@cindex fonts
@cindex faces
@node Navigation
-@comment node-name, next, previous, up
@section Navigation
@cindex navigation
Scroll the man page up the window (@code{scroll-up}).
@item @key{DEL}
+@itemx @key{S-SPC}
@kindex DEL
+@kindex S-SPC
@findex scroll-down
Scroll the man page down the window (@code{scroll-down}).
@node References
-@comment node-name, next, previous, up
@section Following References
@cindex following references
@cindex references
@node Changing
-@comment node-name, next, previous, up
@section Changing the Current Man Page
@cindex changing current man page
@cindex current man page, changing
@node Convenience
-@comment node-name, next, previous, up
@section Convenience Key Bindings
@cindex convenience key bindings
@cindex key bindings, convenience
@node Imenu
-@comment node-name, next, previous, up
@section Imenu Support; Contents Menu
@cindex imenu support
@cindex contents menu
@c ===================================================================
@node Customization
-@comment node-name, next, previous, up
@chapter Customization
@cindex customization
@end menu
@node Interface Options
-@comment node-name, next, previous, up
@section Interface Options
@cindex interface options
@noindent
[for GNU/Linux and Cygwin respectively.] A trailing separator (@file{/}
-for UNIX etc.) on directories is optional and the filename matched if a
+for UNIX etc.)@: on directories is optional and the filename matched if a
directory is specified is the first to match the regexp
@code{man.*\.conf}. If the environment variable @code{MANPATH} is not
set but a configuration file is found then it is parsed instead (or as
@node Formatting Options
-@comment node-name, next, previous, up
@section Formatting Options
@cindex formatting options
@node Faces
-@comment node-name, next, previous, up
@section Faces
@cindex faces
@node Special symbols
-@comment node-name, next, previous, up
@section Special symbols
@cindex special symbols
@c ===================================================================
@node Log
-@comment node-name, next, previous, up
@chapter The *WoMan-Log* Buffer
@cindex log buffer
@cindex buffer, log
@c ===================================================================
@node Technical
-@comment node-name, next, previous, up
@chapter Technical Details
@cindex technical details
@cindex horizontal spacing
@c ===================================================================
@node Bugs
-@comment node-name, next, previous, up
@chapter Reporting Bugs
@cindex reporting bugs
@cindex bugs, reporting
on @uref{http://savannah.gnu.org/projects/emacs/}. If it still fails, please
@item
-send a bug report to @email{bug-gnu-emacs@@gnu.org} and to
-@email{F.J.Wright@@qmw.ac.uk}. Please include the entry from the
+use @kbd{M-x report-emacs-bug} to send a bug report.
+Please include the entry from the
@code{*WoMan-Log*} buffer relating to the problem file, together with
a brief description of the problem. Please indicate where you got the
man source file from, but do not send it unless asked to send it.
@c ===================================================================
@node Acknowledgments
-@comment node-name, next, previous, up
@chapter Acknowledgments
@cindex acknowledgments
fragments, general interest, etc.:
@quotation
-Jari Aalto, @email{jari.aalto@@cs.tpu.fi}@*
-Dean Andrews, @email{dean@@dra.com}@*
-Juanma Barranquero, @email{barranquero@@laley-actualidad.es}@*
-Karl Berry, @email{kb@@cs.umb.edu}@*
-Jim Chapman, @email{jchapman@@netcomuk.co.uk}@*
-Frederic Corne, @email{frederic.corne@@erli.fr}@*
-Peter Craft, @email{craft@@alacritech.com}@*
-Charles Curley, @email{ccurley@@trib.com}@*
-Jim Davidson, @email{jdavidso@@teknowledge.com}@*
-Kevin D'Elia, @email{Kevin.DElia@@mci.com}@*
-John Fitch, @email{jpff@@maths.bath.ac.uk}@*
-Hans Frosch, @email{jwfrosch@@rish.b17c.ingr.com}@*
-Guy Gascoigne-Piggford, @email{ggp@@informix.com}@*
-Brian Gorka, @email{gorkab@@sanchez.com}@*
-Nicolai Henriksen, @email{nhe@@lyngso-industri.dk}@*
-Thomas Herchenroeder, @email{the@@software-ag.de}@*
-Alexander Hinds, @email{ahinds@@thegrid.net}@*
-Stefan Hornburg, @email{sth@@hacon.de}@*
-Theodore Jump, @email{tjump@@cais.com}@*
-Paul Kinnucan, @email{paulk@@mathworks.com}@*
-Jonas Linde, @email{jonas@@init.se}@*
-Andrew McRae, @email{andrewm@@optimation.co.nz}@*
-Howard Melman, @email{howard@@silverstream.com}@*
-Dennis Pixton, @email{dennis@@math.binghamton.edu}@*
-T. V. Raman, @email{raman@@Adobe.com}@*
-Bruce Ravel, @email{bruce.ravel@@nist.gov}@*
-Benjamin Riefenstahl, @email{benny@@crocodial.de}@*
-Kevin Ruland, @email{kruland@@seistl.com}@*
-Tom Schutter, @email{tom@@platte.com}@*
-Wei-Xue Shi, @email{wxshi@@ma.neweb.ne.jp}@*
-Fabio Somenzi, @email{fabio@@joplin.colorado.edu}@*
-Karel Sprenger, @email{ks@@ic.uva.nl}@*
-Chris Szurgot, @email{szurgot@@itribe.net}@*
-Paul A. Thompson, @email{pat@@po.cwru.edu}@*
-Arrigo Triulzi, @email{arrigo@@maths.qmw.ac.uk}@*
-Geoff Voelker, @email{voelker@@cs.washington.edu}@*
-Eli Zaretskii, @email{eliz@@is.elta.co.il}
+@c jari.aalto@@cs.tpu.fi
+Jari Aalto,
+@c dean@@dra.com
+Dean Andrews,
+@c barranquero@@laley-actualidad.es
+Juanma Barranquero,
+@c kb@@cs.umb.edu
+Karl Berry,
+@c jchapman@@netcomuk.co.uk
+Jim Chapman,
+@c frederic.corne@@erli.fr
+Frederic Corne,
+@c craft@@alacritech.com
+Peter Craft,
+@c ccurley@@trib.com
+Charles Curley,
+@c jdavidso@@teknowledge.com
+Jim Davidson,
+@c Kevin.DElia@@mci.com
+Kevin D'Elia,
+@c jpff@@maths.bath.ac.uk
+John Fitch,
+@c jwfrosch@@rish.b17c.ingr.com
+Hans Frosch,
+@c ggp@@informix.com
+Guy Gascoigne-Piggford,
+@c gorkab@@sanchez.com
+Brian Gorka,
+@c nhe@@lyngso-industri.dk
+Nicolai Henriksen,
+@c the@@software-ag.de
+Thomas Herchenroeder,
+@c ahinds@@thegrid.net
+Alexander Hinds,
+@c sth@@hacon.de
+Stefan Hornburg,
+@c tjump@@cais.com
+Theodore Jump,
+@c paulk@@mathworks.com
+Paul Kinnucan,
+@c jonas@@init.se
+Jonas Linde,
+@c andrewm@@optimation.co.nz
+Andrew McRae,
+@c howard@@silverstream.com
+Howard Melman,
+@c dennis@@math.binghamton.edu
+Dennis Pixton,
+@c raman@@Adobe.com
+T. V. Raman,
+@c bruce.ravel@@nist.gov
+Bruce Ravel,
+@c benny@@crocodial.de
+Benjamin Riefenstahl,
+@c kruland@@seistl.com
+Kevin Ruland,
+@c tom@@platte.com
+Tom Schutter,
+@c wxshi@@ma.neweb.ne.jp
+Wei-Xue Shi,
+@c fabio@@joplin.colorado.edu
+Fabio Somenzi,
+@c ks@@ic.uva.nl
+Karel Sprenger,
+@c szurgot@@itribe.net
+Chris Szurgot,
+@c pat@@po.cwru.edu
+Paul A. Thompson,
+@c arrigo@@maths.qmw.ac.uk
+Arrigo Triulzi,
+@c voelker@@cs.washington.edu
+Geoff Voelker,
+@c eliz@@is.elta.co.il
+Eli Zaretskii
@end quotation
@c ===================================================================
@include doclicense.texi
@node Command Index
-@comment node-name, next, previous, up
@unnumbered Command Index
@printindex fn
@node Variable Index
-@comment node-name, next, previous, up
@unnumbered Variable Index
@printindex vr
@page
@node Keystroke Index
-@comment node-name, next, previous, up
@unnumbered Keystroke Index
@printindex ky
@page
@node Concept Index
-@comment node-name, next, previous, up
@unnumbered Concept Index
@printindex cp