X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=man%2Fman1%2Fafppasswd.1;h=860eb693e49b9acaa342d6d6d7c024f5198da751;hb=53aafa98097fa39b62fd0c7914db291a393aa01b;hp=601a4d87c950e244f6ffb8e1970e3ae87e2dac06;hpb=ecfc96169ab669b578e53fa8e13592934fe37788;p=netatalk.git

diff --git a/man/man1/afppasswd.1 b/man/man1/afppasswd.1
index 601a4d87..860eb693 100644
--- a/man/man1/afppasswd.1
+++ b/man/man1/afppasswd.1
@@ -1,63 +1,113 @@
-.TH afppasswd 1 "22 Aug 2004" 2.0.0 Netatalk 
-.SH NAME
+'\" t
+.\"     Title: afppasswd
+.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
+.\"      Date: 22 Mar 2012
+.\"    Manual: Netatalk 3.0
+.\"    Source: Netatalk 3.0
+.\"  Language: English
+.\"
+.TH "AFPPASSWD" "1" "22 Mar 2012" "Netatalk 3.0" "Netatalk 3.0"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
 afppasswd \- netatalk password maintenance utility
-.SH SYNOPSIS
-\fBafppasswd\fR [\-acfn] [ \-p
-\fBpasswd\fR \fBfile\fR ] [ \-u
-\fBminimum\fR \fBuid\fR ]
-.SH DESCRIPTION
-afppasswd allows the maintenance of afppasswd
-files created by netatalk for use by the uams_randnum.so UAM (providing
-the "Randnum exchange" and "2\-Way Randnum exchange" User Authentication
-Modules).
-.PP
-afppasswd can either be called by root with
-parameters, or can be called by local system users with no parameters to
-change their AFP passwords.
-.RS 
+.SH "SYNOPSIS"
+.HP \w'\fBafppasswd\fR\fB\fR\fB\fR\ 'u
+\fBafppasswd\fR\fB\fR\fB\fR [\-acfn] [\-p\ \fIpasswd\fR\ \fIfile\fR] [\-u\ \fIminimum\fR\ \fIuid\fR]
+.SH "DESCRIPTION"
+.PP
+\fBafppasswd\fR
+allows the maintenance of afppasswd files created by netatalk for use by the uams_randnum\&.so UAM (providing the "Randnum exchange" and "2\-Way Randnum exchange" User Authentication Modules)\&.
+.PP
+\fBafppasswd\fR
+can either be called by root with parameters, or can be called by local system users with no parameters to change their AFP passwords\&.
+.if n \{\
+.sp
+.\}
+.RS 4
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.ps +1
 \fBNote\fR
+.ps -1
+.br
 .PP
-With this utility you can only change the passwords used by two
-specific UAMs. As they provide only weak password encryption, the use of
-the "Randnum exchange" and "2\-Way Randnum exchange" UAMs is deprecated
-unless one has to support very old AFP clients, that can not deal with
-the more secure "DHCAST128" UAM instead. Please compare with the [Cross reference to non\-existant ID \(lqauthentication\(rq] inside Netatalk's
-documentation.
+With this utility you can only change the passwords used by two specific UAMs\&. As they provide only weak password encryption, the use of the "Randnum exchange" and "2\-Way Randnum exchange" UAMs is deprecated unless one has to support very old AFP clients, that can not deal with the more secure "DHCAST128" and "DHX2" UAM instead\&. Please compare with the
+Authentication chapter
+inside Netatalk\'s documentation\&.
+.sp .5v
 .RE
-.SH EXAMPLE
-Local user changing their own password:
+.SH "EXAMPLE"
 .PP
+Local user changing their own password:
+.sp
+.if n \{\
+.RS 4
+.\}
 .nf
 example% \fBafppasswd\fR
 Enter NEW AFP password: \fB(hidden)\fR
 Enter NEW AFP password again: \fB(hidden)\fR
-afppasswd: updated password.
+afppasswd: updated password\&.
 .fi
-.SH OPTIONS
-.TP 
+.if n \{\
+.RE
+.\}
+.SH "OPTIONS"
+.PP
 \fB\-a\fR
-Add a new user to the afppasswd
-file.
-.TP 
+.RS 4
+Add a new user to the
+\fBafppasswd\fR
+file\&.
+.RE
+.PP
 \fB\-c\fR
-Create and/or initialize afppasswd file or
-specific user.
-.TP 
+.RS 4
+Create and/or initialize
+\fBafppasswd\fR
+file or specific user\&.
+.RE
+.PP
 \fB\-f\fR
-Force the current action.
-.TP 
+.RS 4
+Force the current action\&.
+.RE
+.PP
 \fB\-p\fR\fI path\fR
-Path to afppasswd file.
-.TP 
+.RS 4
+Path to
+\fBafppasswd\fR
+file\&.
+.RE
+.PP
 \fB\-n\fR
-If cracklib support is built into \fInetatalk\fR this option will cause cracklib
-checking to be disabled, if the superuser does not want to have the
-password run against the cracklib dictionary.
-.TP 
+.RS 4
+If cracklib support is built into
+\fBnetatalk\fR
+this option will cause cracklib checking to be disabled, if the superuser does not want to have the password run against the cracklib dictionary\&.
+.RE
+.PP
 \fB\-u\fR\fI minimum uid\fR
-This is the minimum \fIuser id\fR
-(uid) that afppasswd will use when creating
-users.
+.RS 4
+This is the minimum
+\fIuser id\fR
+(uid) that
+\fBafppasswd\fR
+will use when creating users\&.
+.RE
 .SH "SEE ALSO"
-\fBafpd\fR(8), \fBatalkd\fR(8).
-
+.PP
+\fBafpd\fR(8),
+\fBafp.conf\fR(5)\&.