X-Git-Url: https://git.hcoop.net/hcoop/debian/courier-authlib.git/blobdiff_plain/d9898ee81388d1eff40cf71e85d9ce9b5c1401fe..8cefd203806dc3406799e37deeed619db0546535:/auth_passwd.3

diff --git a/auth_passwd.3 b/auth_passwd.3
index 6651cc6..33e6d3a 100644
--- a/auth_passwd.3
+++ b/auth_passwd.3
@@ -1,78 +1,90 @@
-.\"  <!-- $Id: auth_passwd.sgml,v 1.3 2007/04/01 00:21:34 mrsam Exp $ -->
+'\" t
 .\"  <!-- Copyright 2004 Double Precision, Inc.  See COPYING for -->
 .\"  <!-- distribution information. -->
 .\"     Title: auth_passwd
-.\"    Author: 
-.\" Generator: DocBook XSL Stylesheets v1.72.0 <http://docbook.sf.net/>
-.\"      Date: 04/06/2007
+.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
+.\"      Date: 06/20/2015
 .\"    Manual: Double Precision, Inc.
 .\"    Source: Double Precision, Inc.
+.\"  Language: English
 .\"
-.TH "AUTH_PASSWD" "3" "04/06/2007" "Double Precision, Inc." "Double Precision, Inc."
+.TH "AUTH_PASSWD" "3" "06/20/2015" "Double Precision, Inc." "Double Precision, Inc."
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
 .\" disable hyphenation
 .nh
 .\" disable justification (adjust text to left margin only)
 .ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
 .SH "NAME"
-auth_passwd \- Change account's password
+auth_passwd \- Change account\*(Aqs password
 .SH "SYNOPSIS"
 .sp
-.RS 4
 .nf
-#include <courierauth.h>
+#include <courierauth\&.h>
 .fi
-.RE
-.HP 19
+.HP \w'int\ rc=auth_passwd('u
 .BI "int rc=auth_passwd(const\ char\ *" "service" ", const\ char\ *" "username" ", const\ char\ *" "oldpassword" ", const\ char\ *" "newpassword" ");"
 .SH "DESCRIPTION"
 .PP
 If
-\fIusername\fR's password is
+\fIusername\fR\*(Aqs password is
 \fIoldpassword\fR, it is replaced with
-\fInewpassword\fR.
+\fInewpassword\fR\&.
 \fIservice\fR
-identifies which so\-called "service"'s password is changed; like
+identifies which so\-called "service"\*(Aqs password is changed; like
 \(lqimap\(rq
 or
-\(lqpop3\(rq. Some Courier authentication library's back\-end module can use different passwords for different services.
+\(lqpop3\(rq\&. Some Courier authentication library\*(Aqs back\-end module can use different passwords for different services\&.
 \fIservice\fR
-is ignored if this is not the case.
+is ignored if this is not the case\&.
 .SH "RETURNS"
 .PP
-
 \fBauth_passwd\fR
-returns 0 if the password was succesfully changed. A non\-0 error code indicates a failure..
+returns 0 if the password was succesfully changed\&. A non\-0 error code indicates a failure\&.\&.
 .SH "SEE ALSO"
 .PP
-
-\fI\fBauthlib\fR(3)\fR\&[1],
-\fI\fBauth_generic\fR(3)\fR\&[2],
-\fI\fBauth_login\fR(3)\fR\&[3],
-\fI\fBauth_getuserinfo\fR(3)\fR\&[4],
-\fI\fBauth_enumerate\fR(3)\fR\&[5].
-.SH "REFERENCES"
+\m[blue]\fB\fBauthlib\fR(3)\fR\m[]\&\s-2\u[1]\d\s+2,
+\m[blue]\fB\fBauth_generic\fR(3)\fR\m[]\&\s-2\u[2]\d\s+2,
+\m[blue]\fB\fBauth_login\fR(3)\fR\m[]\&\s-2\u[3]\d\s+2,
+\m[blue]\fB\fBauth_getuserinfo\fR(3)\fR\m[]\&\s-2\u[4]\d\s+2,
+\m[blue]\fB\fBauth_enumerate\fR(3)\fR\m[]\&\s-2\u[5]\d\s+2\&.
+.SH "NOTES"
 .IP " 1." 4
 \fBauthlib\fR(3)
 .RS 4
-\%authlib.html
+\%http://www.courier-mta.org/authlib/authlib.html
 .RE
 .IP " 2." 4
 \fBauth_generic\fR(3)
 .RS 4
-\%auth_generic.html
+\%http://www.courier-mta.org/authlib/auth_generic.html
 .RE
 .IP " 3." 4
 \fBauth_login\fR(3)
 .RS 4
-\%auth_login.html
+\%http://www.courier-mta.org/authlib/auth_login.html
 .RE
 .IP " 4." 4
 \fBauth_getuserinfo\fR(3)
 .RS 4
-\%auth_getuserinfo.html
+\%http://www.courier-mta.org/authlib/auth_getuserinfo.html
 .RE
 .IP " 5." 4
 \fBauth_enumerate\fR(3)
 .RS 4
-\%auth_enumerate.html
+\%http://www.courier-mta.org/authlib/auth_enumerate.html
 .RE