agedu (8928-1) manpage-hyphens.patch

This patch converts several hyphens to minus signs in the manpage as per
lintian warning "hyphen-used-as-minus-sign".

Author: Alexander Prinsier
--- a/agedu.1
+++ b/agedu.1
@@ -42,7 +42,7 @@
 .PP
 Now paste that URL into your web browser, and you will be shown a graphical representation of the disk usage in \fB/home/fred\fP and its immediate subdirectories, with varying colours used to show the difference between disused and recently-accessed data. Click on any subdirectory to descend into it and see a report for its subdirectories in turn; click on parts of the pathname at the top of any page to return to higher-level directories. When you\*(Aqve finished browsing, you can just press Ctrl-D to send an end-of-file indication to \fBagedu\fP, and it will shut down.
 .PP
-After that, you probably want to delete the data file \fBagedu.dat\fP, since it\*(Aqs pretty large. In fact, the command \fBagedu -R\fP will do this for you; and you can chain \fBagedu\fP commands on the same command line, so that instead of the above you could have done
+After that, you probably want to delete the data file \fBagedu.dat\fP, since it\*(Aqs pretty large. In fact, the command \fBagedu \-R\fP will do this for you; and you can chain \fBagedu\fP commands on the same command line, so that instead of the above you could have done
 .PP
 .nf
 $\ \fBagedu\ \-s\ /home/fred\ \-w\ \-R\fP
@@ -92,16 +92,16 @@
 .PP
 Used on its own, \fB-t\fP merely lists the \fItotal\fP disk usage in each subdirectory; \fBagedu\fP\*(Aqs additional ability to distinguish unused from recently-used data is not activated. To activate it, use the \fB-a\fP option to specify a minimum age.
 .PP
-The directory structure stored in \fBagedu\fP\*(Aqs index file is treated as a set of literal strings. This means that you cannot refer to directories by synonyms. So if you ran \fBagedu -s .\fP, then all the path names you later pass to the \fB-t\fP option must be either `\fB.\fP' or begin with `\fB./\fP'. Similarly, symbolic links within the directory you scanned will not be followed; you must refer to each directory by its canonical, symlink-free pathname.
+The directory structure stored in \fBagedu\fP\*(Aqs index file is treated as a set of literal strings. This means that you cannot refer to directories by synonyms. So if you ran \fBagedu \-s .\fP, then all the path names you later pass to the \fB-t\fP option must be either `\fB.\fP' or begin with `\fB./\fP'. Similarly, symbolic links within the directory you scanned will not be followed; you must refer to each directory by its canonical, symlink-free pathname.
 .RE
 .IP "\fB-R\fP or \fB--remove\fP"
-In this mode, \fBagedu\fP deletes its index file. Running just \fBagedu -R\fP on its own is therefore equivalent to typing \fBrm agedu.dat\fP. However, you can also put \fB-R\fP on the end of a command line to indicate that \fBagedu\fP should delete its index file after it finishes performing other operations.
+In this mode, \fBagedu\fP deletes its index file. Running just \fBagedu \-R\fP on its own is therefore equivalent to typing \fBrm agedu.dat\fP. However, you can also put \fB-R\fP on the end of a command line to indicate that \fBagedu\fP should delete its index file after it finishes performing other operations.
 .IP "\fB-D\fP or \fB--dump\fP"
 In this mode, \fBagedu\fP reads an existing index file and produces a dump of its contents on standard output. This dump can later be loaded into a new index file, perhaps on another computer.
 .IP "\fB-L\fP or \fB--load\fP"
 In this mode, \fBagedu\fP expects to read a dump produced by the \fB-D\fP option from its standard input. It constructs an index file from that dump, exactly as it would have if it had read the same data from a disk scan in \fB-s\fP mode.
 .IP "\fB-S\fP \fIdirectory\fP or \fB--scan-dump\fP \fIdirectory\fP"
-In this mode, \fBagedu\fP will scan a directory tree and convert the results straight into a dump on standard output, without generating an index file at all. So running \fBagedu -S /path\fP should produce equivalent output to that of \fBagedu -s /path -D\fP, except that the latter will produce an index file as a side effect whereas \fB-S\fP will not.
+In this mode, \fBagedu\fP will scan a directory tree and convert the results straight into a dump on standard output, without generating an index file at all. So running \fBagedu \-S /path\fP should produce equivalent output to that of \fBagedu \-s /path \-D\fP, except that the latter will produce an index file as a side effect whereas \fB-S\fP will not.
 .RS
 .PP
 (The output will not be exactly \fIidentical\fP, due to a difference in treatment of last-access times on directories. However, it should be effectively equivalent for most purposes. See the documentation of the \fB--dir-atime\fP option in the next section for further detail.)
@@ -179,7 +179,7 @@
 .PP
 The faking of atimes on directories also requires a processing pass over the index file after the main disk scan is complete. \fB--dir-atime\fP also turns this pass off. Hence, this option affects the \fB-L\fP option as well as \fB-s\fP and \fB-S\fP.
 .PP
-(The previous section mentioned that there might be subtle differences between the output of \fBagedu -s /path -D\fP and \fBagedu -S /path\fP. This is why. Doing a scan with \fB-s\fP and then dumping it with \fB-D\fP will dump the fully faked atimes on the directories, whereas doing a scan-to-dump with \fB-S\fP will dump only \fIpartially\fP faked atimes - specifically, each directory\*(Aqs last modification time - since the subsequent processing pass will not have had a chance to take place. However, loading either of the resulting dump files with \fB-L\fP will perform the atime-faking processing pass, leading to the same data in the index file in each case. In normal usage it should be safe to ignore all of this complexity.)
+(The previous section mentioned that there might be subtle differences between the output of \fBagedu \-s /path \-D\fP and \fBagedu \-S /path\fP. This is why. Doing a scan with \fB-s\fP and then dumping it with \fB-D\fP will dump the fully faked atimes on the directories, whereas doing a scan-to-dump with \fB-S\fP will dump only \fIpartially\fP faked atimes - specifically, each directory\*(Aqs last modification time - since the subsequent processing pass will not have had a chance to take place. However, loading either of the resulting dump files with \fB-L\fP will perform the atime-faking processing pass, leading to the same data in the index file in each case. In normal usage it should be safe to ignore all of this complexity.)
 .RE
 .IP "\fB--mtime\fP"
 This option causes \fBagedu\fP to index files by their last modification time instead of their last access time. You might want to use this if your last access times were completely useless for some reason: for example, if you had recently searched every file on your system, the system would have lost all the information about what files you hadn\*(Aqt recently accessed before then. Using this option is liable to be less effective at finding genuinely wasted space than the normal mode (that is, it will be more likely to flag things as disused when they\*(Aqre not, so you will have more candidates to go through by hand looking for data you don\*(Aqt need), but may be better than nothing if your last-access times are unhelpful.
@@ -240,4 +240,4 @@
 In certain circumstances, \fBagedu\fP can report false positives (reporting files as disused which are in fact in use) as well as the more benign false negatives (reporting files as in use which are not). This arises when a file is, semantically speaking, `read' without actually being physically \fIread\fP. Typically this occurs when a program checks whether the file\*(Aqs mtime has changed and only bothers re-reading it if it has; programs which do this include \fBrsync\fP(\fI1\fP) and \fBmake\fP(\fI1\fP). Such programs will fail to update the atime of unmodified files despite depending on their continued existence; a directory full of such files will be reported as disused by \fBagedu\fP but deleting them will cause trouble.
 .SH "LICENCE"
 .PP
-\fBagedu\fP is free software, distributed under the MIT licence. Type \fBagedu --licence\fP to see the full licence text.
+\fBagedu\fP is free software, distributed under the MIT licence. Type \fBagedu \-\-licence\fP to see the full licence text.