Re: Status of manpages-de?

Hi,

thx for quick response.

Martin Schulze schrieb:
> Peter Niederlag wrote:
>
>>recently I had a problem with the german manpage of find.
>>
>>First I reported it to the findutils people:
>>http://savannah.gnu.org/bugs/?func=detailitem&item_id=14227
>
>
> Corrected in CVS with regards to -prune.

thx.

[...]

>>So how's the procedere for updates?
>
>
> People usually notice mistakes and report them, preferably as a patch
> (diff -u).

Of course I do understand the manpower related problem. ;(

Maybe I am allowed to come back to some more general issues again though.

What is the goal of the manpages-de project? Are you trying to rather
provide your own approach to writing a manual page or are you trying to
keep in synch with the upstream man-pages?

How about parts of manpages that have not been translated yet? Rather
drop them or include them untranslated ?

At least I noticed that the 'find' manpage differs quite a little bit
from the upstream manpage. Never thought about that before. ;)

What's missing?
* Section Examples
* Section See Also is misses a lot

What's different?
* Section Synopsis differs

Especially the examples in my opinion are a great deal of help in *any*
manpage so I do miss them in manpages-de/man1/find.1. I'd rather like to
see them in there untranslated than leaving them out.

Anyway I just made an effort to merge in some changes from the original
find manpage and adjust Section Synopsis and the overall structure to
the upstream manpage. You find my unified diff to *latest CVS* as
attachement.

Before going any further into this I'd like to know if this work would
make any sense.

Thx and cheers,
Peter

Index: find.1
===================================================================
RCS file: /var/cvs/infodrom/manpages-de/man1/find.1,v
retrieving revision 1.6
diff -u -r1.6 find.1
--- find.1 20 Aug 2005 05:05:04 -0000 1.6
+++ find.1 20 Aug 2005 10:27:53 -0000
@@ -10,42 +10,153 @@
 .\"
 .TH FIND 1 "1. Juli 1993" "LunetIX Linuxhandbuch" "Dienstprogramme für Benutzer"
 .SH BEZEICHNUNG
-find \- sucht nach bestimmten Dateien
+find \- sucht in einer Verzeichnishierarchie nach Dateien
 .SH SYNTAX
 .B find
-.RI [ Verzeichnis ]
-.RI [ \-Option ...]
-.RI [ \-Test ...]
-.RI [ \-Aktion ...]
+[\-H] [\-L] [\-P] [Verzeichnis...] [Ausdruck]
 .SH BESCHREIBUNG
+Diese Handbuchseite beschreibt die GNU Version von
+.BR find .
+GNU
 .B find
 durchsucht eine oder mehrere
-Verzeichnishierarchien nach Dateien mit bestimmten Eigenschaften, und
-führt damit bestimmte Aktionen aus. Die Eigenschaften können durch
-Tests bestimmt werden.
-.PP
-Optionen, Tests und Aktionen können mit Operatoren zusammengefaßt werden.
+Verzeichnishierarchien und bewertet dabei
+den Ausdruck von links nach rechts
+entsprechend den Regeln der Priorität
+(siehe Abschnitt OPERATOREN)
+bis das Ergebnis bekannt ist
+(die linke Seite ist falsch für \fIUND\fR Operatoren,
+wahr für \fIODER\fR Operatoren).
+Anschließend führt
 .B find
-bewertet für jede Datei in den Verzeichnishierarchien die
-Optionen, Tests und Aktionen von links nach rechts, bis ein falscher
-Wahrheitswert auftaucht oder die Kommandozeilenargumente zu Ende sind.
+die Suche mit der nächsten Datei fort.
+
+.SH OPTIONEN
+Die Optionen `\-H', `\-L' and `\-P'
+bestimmen den Umgang mit symbolischen Links.
+Darauf folgende Kommandozeilenparamter
+müssen die Datei\- oder Verzeichnisnamen sein,
+die untersucht werden sollen.
 .PP
 Das erste Argument, das mit einem
 .BR \- ", einer Klammer " ( ", " ) ", einem Komma " ,
 .RB " oder einem Ausrufezeichen " !
-beginnt, wird als Anfang einer Option oder Test interpretiert. Alle
+beginnt, wird als Anfang eines Ausdrucks interpretiert. Alle
 Argumente davor werden als Verzeichnisnamen interpretiert.
 .PP
 Wenn kein Verzeichnis angegeben ist, wird das aktuelle Verzeichnis genommen.
 Wenn keine Aktion angegeben ist, wird die Aktion
 .B \-print
-ausgeführt.
+ausgeführt (Es wird statdessen empfohlen `\-print0' zu verwenden).
 .PP
-Der Status von
+In dieser Handbuchseite wird auch im Abschnitt
+AUSDRÜCKE über `Optionen' gesprochen.
+Diese Optionen legen das Verhalten
+innerhalb eines Ausdrucks fest,
+und folgen direkt auf den letzten Verzeichnisnamen.
+Die drei `echten' Optionen `\-H', `\-L' and `\-P'
+müssen vor dem ersten Verzeichnisnamen angegeben werden,
+wenn sie verwendet werden sollen.
+.IP \-P
+Keinen symbolischen Links auflösen.
+Dies ist das Standardverhalten.
+Wenn
 .B find
-ist Null, wenn alle Aktionen erfolgreich waren, im Fehlerfall ist der Status
-größer als Null.
-.SH OPTIONEN
+eine Datei untersucht oder Informationen über diese ausgibt,
+und die Datei ein symbolischer Link ist, dann werden die Informationen
+von dem symbolischen Link selbst verwendet.
+
+.IP \-L
+symbolischen Links auflösen.
+Wenn
+.B find
+eine Datei untersucht
+oder Informationen über diese ausgibt,
+dann werden die Informationen von der Datei verwendet,
+auf die der symbolische Link verweist
+(Sofern die Datei zugänglich ist).
+Die Verwendung dieser Opton impliziert die Option \-noleaf.
+If you later use the \-P option, \-noleaf
+will still be in effect. If \-L is in effect and
+.B find
+discovers a symbolic link to a subdirectory during its search,
+the subdirectory pointed to by the symbolic link will be searched.
+.IP
+When the \-L option is in effect, the \-type predicate will always
+match against the type of the file that a symbolic link points to
+rather than the link itself (unless the symbolic link is broken).
+Using \-L causes the \-lname and \-ilname predicates always to return
+false.
+
+.IP \-H
+Do not follow symbolic links, except while processing the command
+line arguments. When
+.B find
+examines or prints information about files, the information used
+shall be taken from the properties of the symbolic link itself. The
+only exception to this behaviour is when a file specified on the
+command line is a symbolic link, and the link can be resolved. For
+that situation, the information used is taken from whatever the link
+points to (that is, the link is followed). The information about the
+link itself is used as a fallback if the file pointed to by the
+symbolic link cannot be examined. If \-H is in effect and one of the
+paths specified on the command line is a symbolic link to a directory,
+the contents of that directory will be examined (though of course
+\-maxdepth 0 would prevent this).
+.P
+If more than one of \-H, \-L and \-P is specified, each overrides the
+others; the last one appearing on the command line takes effect.
+Since it is the default, the \-P option should be considered to be in
+effect unless either \-H or \-L is specified.
+
+GNU
+.B find
+frequently stats files during the processing of the command line
+itself, before any searching has begun. These options also affect how
+those arguments are processed. Specifically, there are a number of
+tests that compare files listed on the command line against a file we
+are currently considering. In each case, the file specified on the
+command line will have been examined and some of its properties will
+have been saved. If the named file is in fact a symbolic link, and
+the \-P option is in effect (or if neither \-H nor \-L were
+specified), the information used for the comparison will be taken from
+the properties of the symbolic link. Otherwise, it will be taken from
+the properties of the file the link points to. If
+.B find
+cannot follow the link (for example because it has insufficient
+privileges or the link points to a nonexistent file) the properties of
+the link itself will be used.
+.P
+When the \-H or \-L options are in effect, any symbolic links listed
+as the argument of \-newer will be dereferenced, and the timestamp
+will be taken from the file to which the symbolic link points. The
+same consideration applies to \-anewer and \-cnewer.
+
+The \-follow option has a similar effect to \-L, though it takes
+effect at the point where it appears (that is, if \-L is not used but
+\-follow is, any symbolic links appearing after \-follow on the
+command line will be dereferenced, and those before it will not).
+
+.P
+.SH AUSDRÜCKE
+.PP
+Ein Ausdruck besteht aus Optionen
+(welche das allgemeine Verhalten der Kommandos bestimmen
+und immer wahr zurückgeben),
+Tests (welche wahr oder falsch zurückgeben)
+und Aktionen (welche wahr oder falsch zurückgeben).
+Optionen, Tests und Aktionen
+werden über Operatoren verknüpft.
+Wenn kein Operator explizit angeben ist
+wird der \fIUND\fR\ Operator \-and verwendet.
+
+Wenn der Ausdruck keine andere Aktion
+als \-prune enthält, wird mit allen Dateien,
+für welche der Ausdruck wahr ergibt,
+die Aktion -print durchgeführt
+
+.SS OPTIONEN
+.P
 Die Optionen bestimmen das allgemeine Verhalten des Kommandos, und
 beziehen sich nicht auf spezielle Dateien. Die Optionen sind immer wahr.
 .TP
@@ -91,6 +202,7 @@
 .B \-xdev
 durchsucht keine Verzeichnisse in anderen Dateisystemen
 (auf anderen Partitionen)
+
 .SS Tests:
 Alle numerischen Argumente können auf drei Arten angegeben werden:
 .RS
@@ -541,6 +653,7 @@
 .B \-ls
 zeigt das Verzeichnis in dem die getestete Datei gefunden wurde mit
 .BR "ls \-dils " an
+
 .SS Operatoren:
 Die Optionen, Tests und Aktionen können mit Operatoren verknüpft
 werden. Die Bearbeitung erfolgt prinzipiell von links nach rechts.
@@ -574,8 +687,120 @@
 .IB Ausdruck1 " , "Ausdruck2
 Liste; beide Ausdrücke werden immer bewertet (ausgeführt); der Wahrheitswert
 des gesamten Ausdrucks entspricht dem von Ausdruck2
+
+.SH "BEISPIELE"
+.nf
+.B find /tmp \-name core \-type f \-print | xargs /bin/rm -f
+
+.fi
+Finde Dateien mit dem Namen
+.B core
+in oder unterhalb des Verzeichnisses
+.B /tmp
+und lösche diese.
+Achtung, diese Aktion schlägt fehl
+falls die Dateinamen Zeilenvorschübe,
+einfache oder doppelte Anführungszeichen
+oder Leerzeichen enthalten.
+.P
+.B find /tmp \-name core \-type f \-print0 | xargs \-0 /bin/rm -f
+
+.fi
+Find files named
+.B core
+in or below the directory
+.B /tmp
+and delete them, processing filenames in such a way that file or
+directory names containing single or double quotes, spaces or newlines
+are correctly handled. The
+.B \-name
+test comes before the
+.B \-type
+test in order to avoid having to call
+.B stat(2)
+on every file.
+
+.P
+.nf
+.B find . \-type f \-exec file '{}' \e\;
+
+.fi
+Runs `file' on every file in or below the current directory. Notice
+that the braces are enclosed in single quote marks to protect them
+from interpretation as shell script punctuation. The semicolon is
+similarly protected by the use of a backslash, though ';' could have
+been used in that case also.
+
+.P
+.nf
+.B find / \t\e( \-perm +4000 \-fprintf /root/suid.txt '%#m %u %p\en' \e) , \e
+.B \t\t\e( \-size +100M \-fprintf /root/big.txt '%\-10s %p\en' \e)
+
+.fi
+Traverse the filesystem just once, listing setuid files and
+directories into
+.B /root/suid.txt
+and large files into
+.BR /root/big.txt .
+
+.P
+.nf
+.B find $HOME -mtime 0
+
+.fi
+Search for files in your home directory which have been modified in
+the last twenty-four hours. This command works this way because the
+time since each file was last modified is divided by 24 hours and any
+remainder is discarded. That means that to match
+.B -mtime
+.BR 0 ,
+a file will have to have a modification in the past which is less than
+24 hours ago.
+
+.P
+.nf
+.B find . -perm 664
+
+.fi
+Search for files which have read and write permission for their owner,
+and group, but which other users can read but not write to. Files
+which meet these criteria but have other permissions bits set (for
+example if someone can execute the file) will not be matched.
+
+.P
+.nf
+.B find . -perm -664
+
+.fi
+Search for files which have read and write permission for their owner
+and group, and which other users can read, without regard to the
+presence of any extra permission bits (for example the executable
+bit). This will match a file which has mode 0777, for example.
+
+.P
+.nf
+.B find . -perm +222
+
+.fi
+Search for files which are writable by somebody (their owner, or
+their group, or anybody else).
+
+.SH EXIT STATUS
+Der Status von
+.B find
+ist Null, wenn alle Aktionen erfolgreich waren, im Fehlerfall ist der Status
+größer als Null.
+.
 .SH "SIEHE AUCH"
-das LunetIX Linuxhandbuch
+das LunetIX Linuxhandbuch,
+\fBlocate\fP(1), \fBlocatedb\fP(5), \fBupdatedb\fP(1), \fBxargs\fP(1),
+\fBfnmatch\fP(3), \fBregex\fP(7), \fBstat\fP(2), \fBlstat\fP(2),
+\fBls\fP(1), \fBprintf\fP(3), \fBstrftime\fP(3), \fBctime\fP(3),
+\fBFinding Files\fP (on-line in Info, or printed),
+.SH "HISTORY"
+As of findutils-4.2.2, shell metacharacters ('*'. '?' or '[]' for
+example) used in filename patterns will match a leading '.', because
+IEEE POSIX interpretation 126 requires this.
 .SH AUTOR
 Eric Decker, David MacKenzie, Jay Plett und Tim Wood
 
Received on Sat, 20 Aug 2005 12:52:54 +0200