Revision: 2197
http://gtkpod.svn.sourceforge.net/gtkpod/?rev=2197&view=rev
Author: tmzullinger
Date: 2009-01-05 04:58:39 +0000 (Mon, 05 Jan 2009)
Log Message:
-----------
Update man page
Add details on gtkpod.load and gtkpod.eject scripts, clean up the
synopsis, and generate the manpage at configure time to set the
version properly.
Modified Paths:
--------------
gtkpod/trunk/ChangeLog
gtkpod/trunk/configure.in
Added Paths:
-----------
gtkpod/trunk/data/man/gtkpod.1.in
Removed Paths:
-------------
gtkpod/trunk/data/man/gtkpod.1
Modified: gtkpod/trunk/ChangeLog
===================================================================
--- gtkpod/trunk/ChangeLog 2009-01-05 04:57:53 UTC (rev 2196)
+++ gtkpod/trunk/ChangeLog 2009-01-05 04:58:39 UTC (rev 2197)
@@ -1,5 +1,8 @@
2009-01-04 Todd Zullinger <tmzullinger at users.sourceforge.net>
+ * configure.in, data/man/gtkpod.1 -> data/man/gtkpod.1.in:
+ Update man page and generate it to set the version properly.
+
* po/zh_CN.po: Add simple Chinese translation (Tan Zhixin)
2008-12-31 Jorg Schuler <jcsjcs at users.sourceforge.net>
Modified: gtkpod/trunk/configure.in
===================================================================
--- gtkpod/trunk/configure.in 2009-01-05 04:57:53 UTC (rev 2196)
+++ gtkpod/trunk/configure.in 2009-01-05 04:58:39 UTC (rev 2197)
@@ -278,6 +278,7 @@
data/icons/hicolor/scalable/Makefile
data/icons/hicolor/scalable/places/Makefile
data/man/Makefile
+data/man/gtkpod.1
doc/Makefile
doc/figures/Makefile
])
Deleted: gtkpod/trunk/data/man/gtkpod.1
===================================================================
--- gtkpod/trunk/data/man/gtkpod.1 2009-01-05 04:57:53 UTC (rev 2196)
+++ gtkpod/trunk/data/man/gtkpod.1 2009-01-05 04:58:39 UTC (rev 2197)
@@ -1,198 +0,0 @@
-.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
-.\"
-.\" Standard preamble:
-.\" ========================================================================
-.de Sh \" Subsection heading
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Vb \" Begin verbatim text
-.ft CW
-.nf
-.ne \\$1
-..
-.de Ve \" End verbatim text
-.ft R
-.fi
-..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
-.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
-. ds C` ""
-. ds C' ""
-'br\}
-.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
-'br\}
-.\"
-.\" If the F register is turned on, we'll generate index entries on stderr for
-.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
-.\" entries marked with X<> in POD. Of course, you'll have to process the
-.\" output yourself in some meaningful fashion.
-.if \nF \{\
-. de IX
-. tm Index:\\$1\t\\n%\t"\\$2"
-..
-. nr % 0
-. rr F
-.\}
-.\"
-.\" For nroff, turn off justification. Always turn off hyphenation; it makes
-.\" way too many mistakes in technical documents.
-.hy 0
-.if n .na
-.\"
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
-.\" Fear. Run. Save yourself. No user-serviceable parts.
-. \" fudge factors for nroff and troff
-.if n \{\
-. ds #H 0
-. ds #V .8m
-. ds #F .3m
-. ds #[ \f1
-. ds #] \fP
-.\}
-.if t \{\
-. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
-. ds #V .6m
-. ds #F 0
-. ds #[ \&
-. ds #] \&
-.\}
-. \" simple accents for nroff and troff
-.if n \{\
-. ds ' \&
-. ds ` \&
-. ds ^ \&
-. ds , \&
-. ds ~ ~
-. ds /
-.\}
-.if t \{\
-. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
-. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
-. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
-. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
-. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
-. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
-.\}
-. \" troff and (daisy-wheel) nroff accents
-.ds :
\\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
-.ds o
\\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
-.ds ae a\h'-(\w'a'u*4/10)'e
-.ds Ae A\h'-(\w'A'u*4/10)'E
-. \" corrections for vroff
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
-. \" for low resolution devices (crt and lpr)
-.if \n(.H>23 .if \n(.V>19 \
-\{\
-. ds : e
-. ds 8 ss
-. ds o a
-. ds d- d\h'-1'\(ga
-. ds D- D\h'-1'\(hy
-. ds th \o'bp'
-. ds Th \o'LP'
-. ds ae ae
-. ds Ae AE
-.\}
-.rm #[ #] #H #V #F C
-.\" ========================================================================
-.\"
-.IX Title "GTKPOD 1"
-.TH GTKPOD 1 "2007-12-21" "gtkpod 0.99.10" "gtkpod Manual"
-.SH "NAME"
-gtkpod \- GTK2 based software for managing songs and playlists on an Apple iPod
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-\&\fBgtkpod\fR [\fB\-h\fR] [\fB\-a\fR] [\fB\-c\fR] [\fB\-o\fR] [\fB\-m\fR
\fIpath\fR] [\fB\-p\fR \fIfilename\fR] [\fB\-\-hash\fR \fIfilename\fR]
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-This manual page briefly describes the gtkpod command.
-.SH "OPTIONS"
-.IX Header "OPTIONS"
-\&\fBgtkpod\fR supports the following options:
-.IP "\fB\-h\fR, \fB\-\-help\fR" 4
-.IX Item "-h, --help"
-Displays the help message.
-.IP "\fB\-m\fR, \fB\-\-mountpoint\fR \fIpath\fR" 4
-.IX Item "-m, --mountpoint path"
-Define the mountpoint of your iPod.
-.IP "\fB\-p\fR \fIfilename\fR" 4
-.IX Item "-p filename"
-Increment playcount for file \fIfilename\fR by one.
-.IP "\fB\-\-hash\fR \fIfilename\fR" 4
-.IX Item "--hash filename"
-Print gtkpod hash for file \fIfilename\fR.
-.SH "FILES"
-.IX Header "FILES"
-.IP "\fI~/.gtkpod/prefs\fR" 4
-.IX Item "~/.gtkpod/prefs"
-Per user configuration file. Should normally only updated through
-the program itself.
-.IP "\fI/etc/gtkpod/prefs\fR" 4
-.IX Item "/etc/gtkpod/prefs"
-Global configuration file. Used if no configuration file exist for the user
-starting gtkpod.
-.IP "\fI~/.gtkpod/gtkpod.in\fR" 4
-.IX Item "~/.gtkpod/gtkpod.in"
-If this file exists, gtkpod will try to execute it at startup
-This is done before attempting to mount the iPod directory (optional)
-or read the iTunesDB (optional)).
-.IP "\fI~/.gtkpod/gtkpod.out\fR" 4
-.IX Item "~/.gtkpod/gtkpod.out"
-If this file exists, gtkpod will try to execute it while exiting the
-program. This is done after attempting to unmount the iPod directory
-(optional) and sending the \*(L"eject\*(R" command to the iPod (optional).
-.IP "\fI/etc/gtkpod/gtkpod.in\fR, \fI/etc/gtkpod/gtkpod.out\fR" 4
-.IX Item "/etc/gtkpod/gtkpod.in, /etc/gtkpod/gtkpod.out"
-Used instead of the per user scripts if the former ones don't exist
-and these do.
-.SH "AUTHOR"
-.IX Header "AUTHOR"
-.Vb 4
-\& Jorg Schuler <jcsjcs at users.sourceforge.net>
-\& Corey Donohoe <atmos at atmos.org>
-\& Adrian Ulrich <pab at blinkenlights.ch>
-\& and others
-.Ve
-.PP
-This manpage was written by Frank Lichtenheld <fr...@lichtenheld>.
-.SH "COPYRIGHT AND LICENCE"
-.IX Header "COPYRIGHT AND LICENCE"
-This program is free software; you can redistribute it and/or modify
-it under the terms of the \s-1GNU\s0 General Public License as published by
-the Free Software Foundation; either version 2, or (at your option)
-any later version.
-.PP
-On Debian systems, a copy of the \s-1GNU\s0 General Public License may be
-found in /usr/share/common\-licenses/GPL.
Copied: gtkpod/trunk/data/man/gtkpod.1.in (from rev 2196,
gtkpod/trunk/data/man/gtkpod.1)
===================================================================
--- gtkpod/trunk/data/man/gtkpod.1.in (rev 0)
+++ gtkpod/trunk/data/man/gtkpod.1.in 2009-01-05 04:58:39 UTC (rev 2197)
@@ -0,0 +1,219 @@
+.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.07)
+.\"
+.\" Standard preamble:
+.\" ========================================================================
+.de Sh \" Subsection heading
+.br
+.if t .Sp
+.ne 5
+.PP
+\fB\\$1\fR
+.PP
+..
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.\" Set up some character translations and predefined strings. \*(-- will
+.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+.\" double quote, and \*(R" will give a right double quote. \*(C+ will
+.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
+.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
+.\" nothing in troff, for use with C<>.
+.tr \(*W-
+.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.ie n \{\
+. ds -- \(*W-
+. ds PI pi
+. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
+. ds L" ""
+. ds R" ""
+. ds C` ""
+. ds C' ""
+'br\}
+.el\{\
+. ds -- \|\(em\|
+. ds PI \(*p
+. ds L" ``
+. ds R" ''
+'br\}
+.\"
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.\"
+.\" If the F register is turned on, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
+.\" entries marked with X<> in POD. Of course, you'll have to process the
+.\" output yourself in some meaningful fashion.
+.ie \nF \{\
+. de IX
+. tm Index:\\$1\t\\n%\t"\\$2"
+..
+. nr % 0
+. rr F
+.\}
+.el \{\
+. de IX
+..
+.\}
+.\"
+.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+.\" Fear. Run. Save yourself. No user-serviceable parts.
+. \" fudge factors for nroff and troff
+.if n \{\
+. ds #H 0
+. ds #V .8m
+. ds #F .3m
+. ds #[ \f1
+. ds #] \fP
+.\}
+.if t \{\
+. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+. ds #V .6m
+. ds #F 0
+. ds #[ \&
+. ds #] \&
+.\}
+. \" simple accents for nroff and troff
+.if n \{\
+. ds ' \&
+. ds ` \&
+. ds ^ \&
+. ds , \&
+. ds ~ ~
+. ds /
+.\}
+.if t \{\
+. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+.\}
+. \" troff and (daisy-wheel) nroff accents
+.ds :
\\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+.ds o
\\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+.ds ae a\h'-(\w'a'u*4/10)'e
+.ds Ae A\h'-(\w'A'u*4/10)'E
+. \" corrections for vroff
+.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+. \" for low resolution devices (crt and lpr)
+.if \n(.H>23 .if \n(.V>19 \
+\{\
+. ds : e
+. ds 8 ss
+. ds o a
+. ds d- d\h'-1'\(ga
+. ds D- D\h'-1'\(hy
+. ds th \o'bp'
+. ds Th \o'LP'
+. ds ae ae
+. ds Ae AE
+.\}
+.rm #[ #] #H #V #F C
+.\" ========================================================================
+.\"
+.IX Title "GTKPOD 1"
+.TH GTKPOD 1 "2009-01-04" "gtkpod @VERSION@" "gtkpod Manual"
+.\" For nroff, turn off justification. Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
+.SH "NAME"
+gtkpod \- GTK2 based software for managing songs and playlists on an Apple iPod
+.SH "SYNOPSIS"
+.IX Header "SYNOPSIS"
+\&\fBgtkpod\fR [\fB\-h\fR] [\fB\-m\fR \fIpath\fR] [\fB\-p\fR \fIfilename\fR]
[\fB\-\-hash\fR \fIfilename\fR]
+.SH "DESCRIPTION"
+.IX Header "DESCRIPTION"
+This manual page briefly describes the gtkpod command.
+.SH "OPTIONS"
+.IX Header "OPTIONS"
+\&\fBgtkpod\fR supports the following options:
+.IP "\fB\-h\fR, \fB\-\-help\fR" 4
+.IX Item "-h, --help"
+Displays the help message.
+.IP "\fB\-m\fR, \fB\-\-mountpoint\fR \fIpath\fR" 4
+.IX Item "-m, --mountpoint path"
+Define the mountpoint of your iPod.
+.IP "\fB\-p\fR \fIfilename\fR" 4
+.IX Item "-p filename"
+Increment playcount for file \fIfilename\fR by one.
+.IP "\fB\-\-hash\fR \fIfilename\fR" 4
+.IX Item "--hash filename"
+Print gtkpod hash for file \fIfilename\fR.
+.SH "FILES"
+.IX Header "FILES"
+.IP "\fI~/.gtkpod/prefs\fR" 4
+.IX Item "~/.gtkpod/prefs"
+Per user configuration file. Should normally only updated through
+the program itself.
+.IP "\fI/etc/gtkpod/prefs\fR" 4
+.IX Item "/etc/gtkpod/prefs"
+Global configuration file. Used if no configuration file exist for the user
+starting gtkpod.
+.IP "\fI~/.gtkpod/gtkpod.in\fR" 4
+.IX Item "~/.gtkpod/gtkpod.in"
+If this file exists, gtkpod will try to execute it at startup
+This is done before attempting to mount the iPod directory (optional)
+or read the iTunesDB (optional).
+.IP "\fI~/.gtkpod/gtkpod.out\fR" 4
+.IX Item "~/.gtkpod/gtkpod.out"
+If this file exists, gtkpod will try to execute it while exiting the
+program. This is done after attempting to unmount the iPod directory
+(optional) and sending the \*(L"eject\*(R" command to the iPod (optional).
+.IP "\fI/etc/gtkpod/gtkpod.in\fR, \fI/etc/gtkpod/gtkpod.out\fR" 4
+.IX Item "/etc/gtkpod/gtkpod.in, /etc/gtkpod/gtkpod.out"
+Used instead of the per user scripts if the former ones don't exist
+and these do.
+.IP "\fI~/.gtkpod/gtkpod.load\fR" 4
+.IX Item "~/.gtkpod/gtkpod.load"
+If this file exists, gtkpod will execute it before loading the contents of
+an iPod with the iPod's mountpoint as the only command line argument. Put
+any commands needed to access the iPod here, for example if you need to
+mount the iPod manually.
+.IP "\fI~/.gtkpod/gtkpod.eject\fR" 4
+.IX Item "~/.gtkpod/gtkpod.eject"
+If this file exists, gtkpod will execute it when ejecting an iPod with the
+the iPod's mountpoint as the only command line argument. Put any commands
+you want to execute after gtkpod has written the changes to the iPod here.
+For example:
+.Sp
+sudo eject \f(CW$1\fR
+.Sp
+gtkpod will not attempt to do any magic of it's own to mount/unmount/eject
+the iPod.
+.SH "AUTHOR"
+.IX Header "AUTHOR"
+.Vb 4
+\& Jorg Schuler <jcsjcs at users.sourceforge.net>
+\& Corey Donohoe <atmos at atmos.org>
+\& Adrian Ulrich <pab at blinkenlights.ch>
+\& and others
+.Ve
+.PP
+This manpage was written by Frank Lichtenheld.
+.SH "COPYRIGHT AND LICENSE"
+.IX Header "COPYRIGHT AND LICENSE"
+This program is free software; you can redistribute it and/or modify
+it under the terms of the \s-1GNU\s0 General Public License as published by
+the Free Software Foundation; either version 2, or (at your option)
+any later version.
This was sent by the SourceForge.net collaborative development platform, the
world's largest Open Source development site.
------------------------------------------------------------------------------
_______________________________________________
gtkpod-cvs2 mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/gtkpod-cvs2
