[Netatalk-cvs] netatalk/man/man3 atalk_aton.3, 1.2, 1.3 nbp_name.3, 1.3, 1.4

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 454-5900

Update of /cvsroot/netatalk/netatalk/man/man3
In directory sfp-cvsdas-3.v30.ch3.sourceforge.com:/tmp/cvs-serv26029/man/man3

Modified Files:
	atalk_aton.3 nbp_name.3 
Log Message:
Checkin all manpages freshly from XML for 2.1beta. Merry christmas!

Index: nbp_name.3
===================================================================
RCS file: /cvsroot/netatalk/netatalk/man/man3/nbp_name.3,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** nbp_name.3	28 Apr 2005 20:50:06 -0000	1.3
--- nbp_name.3	24 Dec 2009 08:05:39 -0000	1.4
***************
*** 1,40 ****
! .TH nbp_name 3 "12 Jan 1994" 2.0.0 Netatalk 
! .SH NAME
  nbp_name \- NBP name parsing
! .SH SYNOPSIS
! int \fInbp_name\fR(char *\fIname\fR, char **\fIobj\fR, char **\fItype\fR, char **\fIzone\fR);
! .SH DESCRIPTION
! nbp_name() parses user supplied names into
! their component object, type, and zone. \fIobj\fR,
! \fItype\fR, and zone
! should be passed by reference, and should point to the caller's
! default values. nbp_name() will change the pointers
! to the parsed\-out values. \fIname\fR is of the
! form \fIobject\fR\fI:\fR\fI\fR\fItype\fR\fI@\fR\fI\fRzone, where each of \fIobject\fR,
! \fI:\fR\fItype\fR\fI,\fR and \fI@\fRzone replace \fIobj\fR,
! \fItype\fR, and \fIzone,\fR
! respectively. \fItype\fR must be proceeded by `\fI:\fR', and zone
! must be preceded by `\fI@\fR'.
! .SH EXAMPLE
! The argument of \fBafpd\fR(8)'s
! \fB\-n\fR option is parsed with nbp_name().
! The default value of \fIobj\fR is the first
! component of the machine's hostname (as returned by
! \fBgethostbyname\fR(3)).
! The default value of \fItype\fR is
! ``AFPServer'', and of zone is
! ``*'', the default zone. To cause \fIafpd\fR
! to register itself in some zone other than the default, one would invoke
! it as
  .PP
  .nf
  afpd \-n @some\-other\-zone
  .fi
  .PP
! \fIobj\fR and \fItype\fR
! would retain their default values.
! .SH BUGS
! \fIobj\fR, \fItype\fR,
! and zone return pointers into static
! area which may be over\-written on each call.
! 
--- 1,88 ----
! '\" t
! .\"     Title: nbp_name
! .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
! .\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
! .\"      Date: 12 Jan 1994
! .\"    Manual: Netatalk 2.1
! .\"    Source: Netatalk 2.1
! .\"  Language: English
! .\"
! .TH "NBP_NAME" "3" "12 Jan 1994" "Netatalk 2.1" "Netatalk 2.1"
! .\" -----------------------------------------------------------------
! .\" * set default formatting
! .\" -----------------------------------------------------------------
! .\" disable hyphenation
! .nh
! .\" disable justification (adjust text to left margin only)
! .ad l
! .\" -----------------------------------------------------------------
! .\" * MAIN CONTENT STARTS HERE *
! .\" -----------------------------------------------------------------
! .SH "NAME"
  nbp_name \- NBP name parsing
! .SH "SYNOPSIS"
! .HP \w'int\ nbp_name('u
! .BI "int nbp_name(char\ *" "name" ", char\ **" "obj" ", char\ **" "type" ", char\ **" "zone" ");"
! .SH "DESCRIPTION"
! .PP
! \fBnbp_name()\fR
! parses user supplied names into their component object, type, and zone\&.
! \fBobj\fR,
! \fBtype\fR, and
! \fIzone\fR
! should be passed by reference, and should point to the caller\'s default values\&.
! \fBnbp_name()\fR
! will change the pointers to the parsed\-out values\&.
! \fBname\fR
! is of the form
! \fIobject\fR\fB:\fR\fItype\fR\fB@\fR\fIzone\fR, where each of
! \fIobject\fR,
! \fB:\fR\fItype\fR\fB,\fR
! and
! \fB@\fR\fIzone\fR
! replace
! \fBobj\fR,
! \fBtype\fR, and
! \fBzone,\fR
! respectively\&.
! \fItype\fR
! must be proceeded by `\fB:\fR\', and
! \fIzone\fR
! must be preceded by `\fB@\fR\'\&.
! .SH "EXAMPLE"
  .PP
+ The argument of
+ \fBafpd\fR(8)\'s
+ \fB\-n\fR
+ option is parsed with
+ \fBnbp_name()\fR\&. The default value of
+ \fBobj\fR
+ is the first component of the machine\'s hostname (as returned by
+ \fBgethostbyname\fR(3))\&. The default value of
+ \fBtype\fR
+ is ``AFPServer\'\', and of
+ \fIzone\fR
+ is ``*\'\', the default zone\&. To cause
+ \fBafpd\fR
+ to register itself in some zone other than the default, one would invoke it as
+ .sp
+ .if n \{\
+ .RS 4
+ .\}
  .nf
  afpd \-n @some\-other\-zone
  .fi
+ .if n \{\
+ .RE
+ .\}
  .PP
! \fBobj\fR
! and
! \fBtype\fR
! would retain their default values\&.
! .SH "BUGS"
! .PP
! \fBobj\fR,
! \fBtype\fR, and
! \fIzone\fR
! return pointers into static area which may be over\-written on each call\&.

Index: atalk_aton.3
===================================================================
RCS file: /cvsroot/netatalk/netatalk/man/man3/atalk_aton.3,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** atalk_aton.3	28 Apr 2005 20:50:06 -0000	1.2
--- atalk_aton.3	24 Dec 2009 08:05:39 -0000	1.3
***************
*** 1,23 ****
! .TH atalk_aton 3 "12 Jan 1994" 2.0.0 Netatalk 
! .SH NAME
  atalk_aton \- AppleTalk address parsing
! .SH SYNOPSIS
  .nf
! #include <sys/types.h>
! #include <netatalk/at.h>
  .fi
! .sp 1
  .PP
! \fIatalk_aton\fR(char * \fIcp\fR, struct at_addr * \fIata\fR);
! .SH DESCRIPTION
! The atalk_aton() routine converts an ASCII
! representation of an AppleTalk address to a format appropriate for system
! calls. Acceptable ASCII representations include both hex and base 10, in
! triples or doubles. For instance, the address `0x1f6b.77' has a
! network part of `8043' and a node part of `119'. This same address
! could be written `8043.119', `31.107.119', or `0x1f.6b.77'. If
! the address is in hex and the first digit is one of `A\-F', a leading
! `0x' is redundant.
  .SH "SEE ALSO"
! \fBatalk\fR(4).
! 
--- 1,40 ----
! '\" t
! .\"     Title: atalk_aton
! .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
! .\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
! .\"      Date: 12 Jan 1994
! .\"    Manual: Netatalk 2.1
! .\"    Source: Netatalk 2.1
! .\"  Language: English
! .\"
! .TH "ATALK_ATON" "3" "12 Jan 1994" "Netatalk 2.1" "Netatalk 2.1"
! .\" -----------------------------------------------------------------
! .\" * set default formatting
! .\" -----------------------------------------------------------------
! .\" disable hyphenation
! .nh
! .\" disable justification (adjust text to left margin only)
! .ad l
! .\" -----------------------------------------------------------------
! .\" * MAIN CONTENT STARTS HERE *
! .\" -----------------------------------------------------------------
! .SH "NAME"
  atalk_aton \- AppleTalk address parsing
! .SH "SYNOPSIS"
! .sp
! .ft B
  .nf
! #include <sys/types\&.h>
! #include <netatalk/at\&.h>
  .fi
! .ft
! .HP \w'atalk_aton('u
! .BI "atalk_aton(char\ *\ " "cp" ", struct\ at_addr\ *\ " "ata" ");"
! .SH "DESCRIPTION"
  .PP
! The
! \fBatalk_aton()\fR
! routine converts an ASCII representation of an AppleTalk address to a format appropriate for system calls\&. Acceptable ASCII representations include both hex and base 10, in triples or doubles\&. For instance, the address `0x1f6b\&.77\' has a network part of `8043\' and a node part of `119\'\&. This same address could be written `8043\&.119\', `31\&.107\&.119\', or `0x1f\&.6b\&.77\'\&. If the address is in hex and the first digit is one of `A\-F\', a leading `0x\' is redundant\&.
  .SH "SEE ALSO"
! .PP
! \fBatalk\fR(4)\&.