Fix various formatting issues in the manual.

This commit is contained in:
Adam Spiers 2012-02-18 15:46:14 +00:00
parent 2ae90481cb
commit 934ff5e273

View file

@ -311,7 +311,7 @@ this nomenclature with the wording used in @ref{Deferred Operation}.)
For example, the following options For example, the following options
@example @example
--defer='man' --defer='info' --defer=man --defer=info
@end example @end example
@noindent @noindent
@ -330,7 +330,7 @@ stowed, even if the file is already stowed to another package. For example,
the following options the following options
@example @example
--override='man' --override='info' --override=man --override=info
@end example @end example
@noindent @noindent
@ -837,15 +837,15 @@ directory.
@node Resource Files, Compile-time vs Install-time, Target Maintenance, Top @node Resource Files, Compile-time vs Install-time, Target Maintenance, Top
@chapter Resource Files @chapter Resource Files
Default command line options may be set in `.stowrc' (current directory) or Default command line options may be set in @file{.stowrc} (current directory) or
`~/.stowrc' (home directory). These are parsed in that order, and effectively @file{~/.stowrc} (home directory). These are parsed in that order, and effectively
prepended to you command line. This feature can be used for some interesting prepended to you command line. This feature can be used for some interesting
effects. effects.
For example, suppose your site uses more than one stow directory, perhaps in For example, suppose your site uses more than one stow directory, perhaps in
order to share around responsibilities with a number of systems order to share around responsibilities with a number of systems
administrators. One of the administrators might have the following in there administrators. One of the administrators might have the following in there
`~/.stowrc' file: @file{~/.stowrc} file:
@example @example
--dir=/usr/local/stow2 --dir=/usr/local/stow2
@ -854,13 +854,13 @@ administrators. One of the administrators might have the following in there
--ignore='^CVS' --ignore='^CVS'
@end example @end example
so that the `stow' command will default to operating on the @file{/usr/local/stow2} so that the @command{stow} command will default to operating on the
directory, with @file{/usr/local} as the target, and ignoring vi backup files @file{/usr/local/stow2} directory, with @file{/usr/local} as the
and CVS directories. target, and ignoring vi backup files and CVS directories.
If you had a stow directory `/usr/local/stow/perl-extras' that was only used If you had a stow directory @file{/usr/local/stow/perl-extras} that
for Perl modules, then you might place the following in was only used for Perl modules, then you might place the following in
`/usr/local/stow/perl-extras/.stowrc': @file{/usr/local/stow/perl-extras/.stowrc}:
@example @example
--dir=/usr/local/stow/perl-extras --dir=/usr/local/stow/perl-extras
@ -872,11 +872,12 @@ for Perl modules, then you might place the following in
--ignore='\.bs' --ignore='\.bs'
@end example @end example
so that the when your are in the @file{/usr/local/stow/perl-extras} directory, so that the when your are in the @file{/usr/local/stow/perl-extras}
`stow' will regard any subdirectories as stow packages, with @file{/usr/local} directory, @command{stow} will regard any subdirectories as stow
as the target (rather than the immediate parent directoy packages, with @file{/usr/local} as the target (rather than the
@file{/usr/local/stow}), overriding any pre-existing links to bin files or man immediate parent directory @file{/usr/local/stow}), overriding any
pages, and ignoring some cruft that gets installed by default. pre-existing links to bin files or man pages, and ignoring some cruft
that gets installed by default.
@c =========================================================================== @c ===========================================================================
@ -929,10 +930,10 @@ script using the same shell that @samp{make install} would have used.
@enumerate @enumerate
@item @item
Replace all lines matching @samp{make[@var{n}]: Entering directory Replace all lines matching @samp{make[@var{n}]: Entering directory
`@var{dir}'} with @samp{pushd @var{dir}}. @var{dir}} with @samp{pushd @var{dir}}.
@item @item
Replace all lines matching @samp{make[@var{n}]: Leaving directory Replace all lines matching @samp{make[@var{n}]: Leaving directory
`@var{dir}'} with @samp{popd}. @var{dir}} with @samp{popd}.
@item @item
Delete all lines matching @samp{make[@var{n}]: Nothing to be done for Delete all lines matching @samp{make[@var{n}]: Nothing to be done for
@var{rule}}. @var{rule}}.