From 1b75323e1ce44b4fa7d7dba9fd936264bb397216 Mon Sep 17 00:00:00 2001 From: "Dirk-Jan C. Binnema" Date: Mon, 23 Aug 2010 08:23:58 +0300 Subject: [PATCH] * many: small cosmetic / documentation updates --- contrib/mu-completion.zsh | 7 +++++-- man/mu-cleanup.1 | 2 +- man/mu-index.1 | 7 ++++--- man/mu.1 | 35 ++++++++++++++++++++++++----------- src/mu-cmd.c | 5 +---- src/mu-cmd.h | 2 +- 6 files changed, 36 insertions(+), 22 deletions(-) diff --git a/contrib/mu-completion.zsh b/contrib/mu-completion.zsh index 632dd851..f38aab13 100644 --- a/contrib/mu-completion.zsh +++ b/contrib/mu-completion.zsh @@ -1,5 +1,4 @@ #compdef mu -#-*-mode:sh-*- ## Copyright (C) 2008-2010 Dirk-Jan C. Binnema ## @@ -38,7 +37,7 @@ _mu_view() { } _mu_extract() { - _files + _files } _mu_find() { @@ -74,3 +73,7 @@ _mu() { _mu "$@" + +# Local variables: +# mode: sh +# End: diff --git a/man/mu-cleanup.1 b/man/mu-cleanup.1 index 9208788b..830800ae 100644 --- a/man/mu-cleanup.1 +++ b/man/mu-cleanup.1 @@ -20,7 +20,7 @@ be found, from the database. Note that this is done automatically when running .SH ENVIRONMENT Like \fBmu index\fR, \fBmu cleanup\fR uses \fBMAILDIR\fR to find the user's -Maildir if it has not been specified explicitly +Maildir if it has not been specified explicitly with \fB\-\-maildir\fR=\fI\fR. If MAILDIR is not set, \fBmu cleanup\fR will try \fI~/Maildir\fR. . diff --git a/man/mu-index.1 b/man/mu-index.1 index 5c4c9e68..75df653c 100644 --- a/man/mu-index.1 +++ b/man/mu-index.1 @@ -166,10 +166,11 @@ To store these files elsewhere from their default location, one can use the .SH ENVIRONMENT -As mentioned, \fBmu index\fR uses \fBMAILDIR\fR to find the user's Maildir if -it has not been specified explicitly \fB\-\-maildir\fR=\fI\fR. If -MAILDIR is not set, \fBmu index\fR will try \fI~/Maildir\fR. +\fBmu index\fR uses \fBMAILDIR\fR to find the user's Maildir if it has not +been specified explicitly with \fB\-\-maildir\fR=\fI\fR. If MAILDIR +is not set, \fBmu index\fR will try \fI~/Maildir\fR. . + .SH BUGS There probably are some; please report bugs when you find them: diff --git a/man/mu.1 b/man/mu.1 index e7e13d1c..5adce24a 100644 --- a/man/mu.1 +++ b/man/mu.1 @@ -16,6 +16,8 @@ mu \- index and search e-mail messages stored in Maildirs .B mu mkdir [options] [] +.B mu extract [options] [] + .B mu [options] .SH DESCRIPTION @@ -68,9 +70,20 @@ for creating Maildirs. See .BR mu-mkdir(1) \. + .TP -The various commands are discussed in their separate manpages; here the -general options are discussed. +\fBextract\fR +for extract MIME-parts (such as attachments) from messages. See +.BR mu-extract(1) +\. + +Subcommands \findex\fR, \ffind\fR and \cleanup\fR work with the database, +while the other ones work on invidual mail files. Hence, running \fview\fR, +\fBmkdir\fR and \fBextract\fR does not require the mu database. + +.TP +The various commands are discussed in more detail in their own separate +man-pages; here the general options are discussed. .SH GENERAL OPTIONS @@ -113,12 +126,6 @@ list the various command line options, while \fB\-\-help\-index\fR, \fB\-\-help\-find\fR and \fB\-\-help\-all\fR list only the options for one command, or all of the commands. -.SH ENVIRONMENT - -As mentioned, \fBmu index\fR uses \fBMAILDIR\fR to find the user's Maildir if -it has not been specified explicitly \fB\-\-maildir\fR=\fI\fR. If -MAILDIR is not set, \fBmu index\fR will try \fI~/Maildir\fR. -. .SH BUGS There probably are some; please report bugs when you find them: @@ -131,7 +138,13 @@ Dirk-Jan C. Binnema .SH "SEE ALSO" .BR mu-index(1) -.BR mu-find(1) -.BR mu-mkdir(1) -.BR mu-view(1) + .BR mu-cleanup(1) + +.BR mu-find(1) + +.BR mu-mkdir(1) + +.BR mu-view(1) + +.BR mu-extract(1) diff --git a/src/mu-cmd.c b/src/mu-cmd.c index e3805ac4..41e6729a 100644 --- a/src/mu-cmd.c +++ b/src/mu-cmd.c @@ -79,10 +79,7 @@ show_version (void) "mu (mail indexer / searcher version) " VERSION "\n\n" "Copyright (C) 2008-2010 Dirk-Jan C. Binnema\n" "License GPLv3+: GNU GPL version 3 or later " - ".\n\n" - "This is free software: you are free to change " - "and redistribute it.\n" - "There is NO WARRANTY, to the extent permitted by law."; + "."; g_print ("%s\n", msg); diff --git a/src/mu-cmd.h b/src/mu-cmd.h index 4d327cf7..01a2b700 100644 --- a/src/mu-cmd.h +++ b/src/mu-cmd.h @@ -1,5 +1,5 @@ /* -** Copyright (C) 2010 Dirk-Jan C. Binnema +** Copyright (C) 2008-2010 Dirk-Jan C. Binnema ** ** This program is free software; you can redistribute it and/or modify it ** under the terms of the GNU General Public License as published by the