diff options
author | 2012-12-07 22:02:53 +0100 | |
---|---|---|
committer | 2012-12-07 22:02:53 +0100 | |
commit | 5d75b6b326242749aa78dbc7b19716e2855a9229 (patch) | |
tree | d4383a96d2732bcc1ccd764fbb94fd8b13738f54 | |
parent | Add commandline option to update localelist. (diff) | |
download | localepurge-5d75b6b326242749aa78dbc7b19716e2855a9229.tar.gz localepurge-5d75b6b326242749aa78dbc7b19716e2855a9229.tar.bz2 localepurge-5d75b6b326242749aa78dbc7b19716e2855a9229.zip |
Man page refresh; option list, file list, add update locales description.
-rw-r--r-- | localepurge.8 | 133 |
1 files changed, 62 insertions, 71 deletions
diff --git a/localepurge.8 b/localepurge.8 index bfcf3ee..fc9890b 100644 --- a/localepurge.8 +++ b/localepurge.8 @@ -1,95 +1,86 @@ .TH LOCALEPURGE 8 .SH NAME localepurge \- removing superfluous locale data + .SH SYNOPSIS .B localepurge .br + .SH "DESCRIPTION" .BR localepurge is a small script to recover disk space wasted for unneeded locale files and localized man pages. It will be automagically invoked by -.BR emerge -some day... -You have to define the locale -directory names you want to keep from removal -in the -.BR /etc/locale.nopurge +\fBemerge\fP some day... You have to define the locale directory +names you want to keep from removal in the \fB/etc/locale.nopurge\fP configuration file. .br -Any other directory (or file) in -.BR /usr/share/locale -not containing a subdirectory named -.BR LC_MESSAGES -will be discreetly ignored. +Any other directory (or file) in \fB/usr/share/locale\fP not containing +a subdirectory named \fBLC_MESSAGES\fP will be discreetly ignored. + .SH OPTIONS The configurable options consist of toggling verbose output, reporting a summary of freed space, and deletion of localized manual pages in -addition to locale files. All actions are specified in the -.BR /etc/locale.nopurge -configuration file. -For detailed debugging the commandline switch -.BR -debug -or just a short -.BR -d -instead are available for usage. -For verbose output the commandline switch -.BR -verbose -or just a short -.BR -v -can be added. You can use too -.BR -help -to have help ;) or a short -.BR -h. -You can use too -.BR -version -and if you dont like colors you can use -.BR -nocolor -or the short form -.BR -nc -if you want a pretend mode you can use -.BR -pretend -or the short from -.BR -p -enjoy. +addition to locale files. Some actions can be specified in the +\fB/etc/locale.nopurge\fP configuration file. + +.IP "\fB\-u\fP \fB\-update\fP" 8 +Update the used localelist. + +.IP "\fB\-d\fP \fB\-debug\fP" 8 +Enable detailed debugging. + +.IP "\fB\-p\fP \fB\-pretend\fP" 8 +Lists the files that would be removed when not pretending. + +.IP "\fB\-v\fP \fB\-verbose\fP" 8 +Enable verbose output. + +.IP "\fB\-h\fP \fB\-help\fP" 8 +Output all options. + +.IP "\fB\-nc\fP \fB\-nocolor\fP" 8 +Disables the use of colors in the output. + +.IP "\fB\-version\fP" 8 +Outputs the installed version. .SH "A Word of CAUTION" -Please note, that -.BR this -.BR tool -.BR is -.BR a -.BR hack -.BR which -.BR is -.BR not -.BR integrated -.BR with -.BR Gentoo -.BR Portage -.BR system -and therefore is not meant for the faint of heart. Responsibility for its -usage and possible breakage of your system therefore lies in the sysadmin's -(your) hands. +Please note, that \fBthis tool is a hack which is not integrated with the +Gentoo Portage system\fP and therefore is not meant for the faint of heart. +Responsibility for its usage and possible breakage of your system therefore +lies in the sysadmin's (your) hands. .br Please definitely do abstain from reporting any bugs blaming localepurge if -.BR you -break your system by using it. If you don't know what you are doing and -can't handle any resulting breakage on your own then please simply don't +\fByou\fP break your system by using it. If you don't know what you are doing +and can't handle any resulting breakage on your own then please simply don't use it. .br All locale directories containing a subdirectory named LC_MESSAGES -which are either commented out or not even listed at all in -.BR /etc/locale.nopurge -will be irreversibly deleted. The only way to -reinstall any lost locales is "remerging" -the ebuild. +which are either commented out or not even listed at all in \fB/etc/locale.nopurge\fP +will be irreversibly deleted. The only way to reinstall any lost locales is +"remerging" the ebuild. + .SH FILES -.BR /etc/locale.nopurge -.SH SEE ALSO +.IP "\fB/etc/locale.nopurge\fP" 8 +This is the main configuration file. You can set the localedirs to check +and locales to keep. Also configure some of the available options. + +.IP "\fB/var/cache/localepurge/localelist\fP" 8 +This file contains all locales that can potentially be removed. If this +file does not exist, don't worry, it will be made when localepurge runs +for the first time or by updating the localelist. + +.IP "\fB/var/cache/localepurge/localelist-glibc\fP" 8 +This file is generated using the \fB/usr/share/i18n/SUPPORTED\fP file +from glibc and contains all locales that can be used by localepurge. +This file is also generated when starting for the first time or updating +the localelist. + +.IP "\fB/var/cache/localepurge/localelist-extra\fP" 8 +This packaged file contains locales that can be installed on the system, +but are not in localelist-glibc. + .SH AUTHOR -.BR localepurge -and its accompanying manual page was written for the -.BR Gentoo -.BR Linux -system by José Alberto Suárez López. Based in the grat job for Debian -GNU/Linux of Paul Seelig <pseelig@debian.org>. +\fBlocalepurge\fP and its accompanying manual page was written for the +\fBGentoo Linux\fP system by Jos� Alberto Su�rez L�pez. Based in the great +job for Debian GNU/Linux of Paul Seelig <pseelig@debian.org>. |