empserver/info/apropos.t
Markus Armbruster 4ea4a01fd5 (info, html): Implement.
(all): Depend on info.

Flatten info directory.  This undoes the move to one subdirectory per
chapter, which was done during Empire 2.  The structure doesn't buy us
much, as the info name space is flat, and it complicates makefiles.

Overhaul info.pl:
- It now wants to run in the root of the build tree.
- Information on source files and subjects is now stored in makefiles,
  thus info.pl no longer picks up random junk from the file system.
- Clean up Perl anachronisms, in particular use subroutine arguments and
  results rather than global variables where convenient.
- Change format of diagnostics to the common format used by GNU tools,
  so that Emacs and the like can parse it.
- Catch missing .SA.
- When creating a new subject file, cowardly refuse to overwrite an
  existing file.
- Subject files contain topics sorted by chapter, then by name.  The
  order of chapters used to depend on how Perl sorts hash keys.  Fix
  it.
2005-12-22 10:09:17 +00:00

24 lines
819 B
Perl

.TH Command APROPOS
.NA apropos "Searches info pages for information on a topic"
.LV Basic
.SY "apropos <searchword> [maxhits]"
.s1
The Empire info pages are organized by subject. It can sometimes be hard to
find the exact page with the information in which you are interested.
To get a list of subjects containing the word you are looking for, type:
.EX apropos <word>
.s1
without the < and > brackets.
.s1
You can then type:
.EX apropos bridge
to get a list of Empire commands and info topics which contain the
word bridge, as well as the line that mentions it.
.s1
Apropos is not case sensitive, thus the above example will find
pages with Bridge or bridge (or even bRiDgE).
.s1
By default, apropos exits when 100 hits are found. You can change this value
with an optional second parameter.
.s1
.SA "info, Playing"