From 39786370fe836cdedac653cc6d0e0de48b88e8b4 Mon Sep 17 00:00:00 2001 From: Vladimir Romanov Date: Wed, 30 Jan 2013 08:03:20 -0800 Subject: [PATCH] man pages: misc fixes and style tweaks --- man/ebuild.1 | 2 +- man/env-update.1 | 14 +++++++------- man/etc-update.1 | 44 ++++++++++++++++++++------------------------ 3 files changed, 28 insertions(+), 32 deletions(-) diff --git a/man/ebuild.1 b/man/ebuild.1 index 600fed3f4..0a937ae70 100644 --- a/man/ebuild.1 +++ b/man/ebuild.1 @@ -179,7 +179,7 @@ tarball is created and stored in \fBPKGDIR\fR (see \fBmake.conf\fR(5)). Builds a RedHat RPM package from the files in the temporary \fIinstall directory\fR. At the moment, the ebuild's dependency information is not incorporated into the RPM. -.SH OPTIONS +.SH "OPTIONS" .TP .BR "\-\-debug" Run bash with the \-x option, causing it to output verbose debugging diff --git a/man/env-update.1 b/man/env-update.1 index 4561ab4b9..c0503ceb0 100644 --- a/man/env-update.1 +++ b/man/env-update.1 @@ -1,26 +1,26 @@ .TH "ENV-UPDATE" "1" "Aug 2008" "Portage VERSION" "Portage" -.SH NAME +.SH "NAME" env\-update \- updates environment settings automatically -.SH SYNOPSIS +.SH "SYNOPSIS" \fBenv\-update\fR \fI[options]\fR -.SH DESCRIPTION +.SH "DESCRIPTION" .B env\-update reads the files in \fI/etc/env.d\fR and automatically generates \fI/etc/profile.env\fR and \fI/etc/ld.so.conf\fR. Then \fBldconfig\fR(8) is run to update \fI/etc/ld.so.cache\fR. \fBenv-update\fR is run by \fBemerge\fR(1) automatically after each package merge. Also, if you -make changes to \fI/etc/env.d\fR, you should run \fIenv-update\fR +make changes to \fI/etc/env.d\fR, you should run \fBenv-update\fR yourself for changes to take effect immediately. Note that this would only affect new processes. In order for the changes to affect your active shell, you will probably have to run \fIsource /etc/profile\fR first. -.SH OPTIONS +.SH "OPTIONS" .TP .B \-\-no\-ldconfig -Do not run ldconfig (and thus skip rebuilding the ld.so cache, etc...). +Do not run \fBldconfig\fR (and thus skip rebuilding the \fIld.so.cache\fR, etc...). .SH "REPORTING BUGS" Please report bugs via http://bugs.gentoo.org/ -.SH AUTHORS +.SH "AUTHORS" Daniel Robbins .SH "SEE ALSO" .BR emerge (1), diff --git a/man/etc-update.1 b/man/etc-update.1 index 366e8500b..2662de57a 100644 --- a/man/etc-update.1 +++ b/man/etc-update.1 @@ -1,28 +1,24 @@ .TH "ETC-UPDATE" "1" "Mar 2012" "Portage VERSION" "Portage" -.SH NAME -etc-update \- handle configuration file updates -.SH SYNOPSIS -.BR etc-update +.SH "NAME" +etc\-update \- handle configuration file updates +.SH "SYNOPSIS" +.BR etc\-update [\fIoptions\fR] [\fI--automode \fR] [\fIpaths to scan\fR] -.SH DESCRIPTION -.I etc-update -is supposed to be run after merging a new package to see if +.SH "DESCRIPTION" +\fIetc\-update\fR is supposed to be run after merging a new package to see if there are updates to the configuration files. If a new configuration file will override an old one, -.I etc-update -will prompt the user for a decision. +\fIetc\-update\fR will prompt the user for a decision. .PP -.I etc-update -will check all directories specified on the command line. If no paths -are given, then the \fICONFIG_PROTECT\fR variable will be used. All -config files found in \fICONFIG_PROTECT_MASK\fR will automatically be -updated for you by \fIetc-update\fR. See \fBmake.conf\fR(5) for more -information. +\fIetc\-update\fR will check all directories specified on the command +line. If no paths are given, then the \fICONFIG_PROTECT\fR variable +will be used. All config files found in \fICONFIG_PROTECT_MASK\fR will +automatically be updated for you by \fIetc\-update\fR. +See \fBmake.conf\fR(5) for more information. .PP -.I etc-update -respects the normal \fIPORTAGE_CONFIGROOT\fR and \fIEROOT\fR variables -for finding the aforementioned config protect variables. -.SH OPTIONS +\fIetc\-update\fR respects the normal \fIPORTAGE_CONFIGROOT\fR and +\fIEROOT\fR variables for finding the aforementioned config protect variables. +.SH "OPTIONS" .TP .BR \-d ", " \-\-debug Run with shell tracing enabled. @@ -37,11 +33,11 @@ Automerge trivial changes only and quit. Show settings and important decision info while running. .TP .BR "\-\-automode " -Select one of the automatic merge modes. Valid modes are: -3 -5 -7 -9. +Select one of the automatic merge modes. Valid modes are: \-3 \-5 \-7 \-9. See the \fI\-\-help\fR text for more details. .SH "REPORTING BUGS" Please report bugs via http://bugs.gentoo.org/ -.SH AUTHORS +.SH "AUTHORS" .nf Jochem Kossen and Leo Lipelis Karl Trygve Kalleberg @@ -49,8 +45,8 @@ Mike Frysinger .fi .SH "FILES" .TP -.B /etc/etc-update.conf -Configuration settings for \fIetc-update\fR are stored here. +.B /etc/etc\-update.conf +Configuration settings for \fIetc\-update\fR are stored here. .SH "SEE ALSO" -.BR dispatch-conf (1), +.BR dispatch\-conf (1), .BR make.conf (5) -- 2.26.2