* More *roff fixes.

This commit is contained in:
Colin Watson 2007-12-04 06:42:32 +00:00
parent 2d704f9165
commit 39938465a5
5 changed files with 46 additions and 28 deletions

1
debian/changelog vendored
View File

@ -13,6 +13,7 @@ ubuntu-dev-tools (0.23) UNRELEASED; urgency=low
[ Colin Watson ] [ Colin Watson ]
* Add a SYNOPSIS section to submittodebian(1) to clarify that it takes no * Add a SYNOPSIS section to submittodebian(1) to clarify that it takes no
arguments. arguments.
* More *roff fixes.
-- Luke Yelavich <themuso@ubuntu.com> Sat, 24 Nov 2007 07:49:32 +1100 -- Luke Yelavich <themuso@ubuntu.com> Sat, 24 Nov 2007 07:49:32 +1100

View File

@ -8,7 +8,7 @@
get\-build\-deps \- install build dependencies for one or more packages get\-build\-deps \- install build dependencies for one or more packages
.\" .\"
.SH SYNOPSIS .SH SYNOPSIS
\fBget\-build\-deps\fP [\fIPACKAGE(S)\fR] \fBget\-build\-deps\fP [\fIPACKAGE\fR...]
.\" .\"
.SH DESCRIPTION .SH DESCRIPTION
\fBget\-build\-deps\fP is a script to install the build dependencies for either a \fBget\-build\-deps\fP is a script to install the build dependencies for either a
@ -16,40 +16,47 @@ local source package or one or more packages from the repositories.
.PP .PP
In order to obtain all missing build dependencies for a package on which source In order to obtain all missing build dependencies for a package on which source
you are currently working, just run this script without any argument, and it'll you are currently working, just run this script without any argument, and it'll
read it's debian/control file to determine the missing build dependencies. read its debian/control file to determine the missing build dependencies.
.PP .PP
Alternatively, you can call it with a list of space-separated package names, or the Alternatively, you can call it with a list of space-separated package names, or the
name of a single file which contains the package names each on a line. Then it will name of a single file which contains the package names each on a line.
install the missing dependencies for those packages using "apt-get build-dep". Then it will install the missing dependencies for those packages using
"apt-get build-dep".
.\" .\"
.SH EXAMPLES .SH EXAMPLES
.TP .TP
get\-build\-deps get\-build\-deps
Looks for a the debian/control file in the current working directory and installs the Looks for a debian/control file in the current working directory and installs the
dependencies listed there. dependencies listed there.
.TP .TP
get\-build\-deps geany get\-build\-deps geany
Installs the build dependencies for version of «geany» that's in the repositories. Installs the build dependencies for the version of
.B geany
that's in the repositories.
.TP .TP
get\-build\-deps geany epiphany-browser rhythmbox get\-build\-deps geany epiphany-browser rhythmbox
Same as the previous example but also with the dependencies for «epiphany-browser» Same as the previous example but also with the dependencies for
and «rhythmbox». .B epiphany-browser
and
.BR rhythmbox .
.TP .TP
get\-build\-deps ./package_list.txt get\-build\-deps ./package_list.txt
Reads the file «package_list.txt» (relatively to the current working directory), Reads the file
.B package_list.txt
(relative to the current working directory),
where each line contains the name of a package, and installs the dependencies where each line contains the name of a package, and installs the dependencies
for the versions of all those that's in the repositories. for the versions of all those that are in the repositories.
.\" .\"
.SH KNOWN BUGS AND LIMITATIONS .SH KNOWN BUGS AND LIMITATIONS
When it's being used to install the missing dependencies for a local source package When it's being used to install the missing dependencies for a local source package
(ie, no arguments are passed to it) it doesn't check for the dependencies to match (i.e., no arguments are passed to it) it doesn't check for the dependencies to match
the indicated versions, but just installs the newest one available in the repositories. the indicated versions, but just installs the newest one available in the repositories.
.\" .\"
.SH SEE ALSO .SH SEE ALSO
\fBdpkg-checkbuilddeps(1)\fR, .BR dpkg-checkbuilddeps (1),
\fBapt-get(8)\fR .BR apt-get (8)
.SH AUTHORS .SH AUTHORS
.\" .\"
\fBget\-build\-deps\fP and this manual page have been written by Siegfried-Angel \fBget\-build\-deps\fP and this manual page have been written by Siegfried-Angel
Gevatter Pujals <siggi.gevatter@gmail.com>. They are released under the GNU General Gevatter Pujals <siggi.gevatter@gmail.com>.
Public License, version 3 or later. They are released under the GNU General Public License, version 3 or later.

View File

@ -5,32 +5,41 @@ requestsync \- helper to file sync requests for Ubuntu
.B requestsync\fR [\fB\-ns\fR] [\fB-k \fIkeyid\fR] <\fBsource package\fR> <\fBtarget release\fR> [\fIbase version\fR] .B requestsync\fR [\fB\-ns\fR] [\fB-k \fIkeyid\fR] <\fBsource package\fR> <\fBtarget release\fR> [\fIbase version\fR]
.SH DESCRIPTION .SH DESCRIPTION
.PP .PP
\fBrequestsync\fR looks at the versions of <source package> in Debian and Ubuntu and prompts for an explanation of why the Ubuntu changes (if there are any) should be dropped. The changelog entry is then downloaded from packages.debian.org, followed by prompt for your GPG passphrase so that it can sign the mail and send it off, to file a sync request in the form of a bug report in Launchpad. \fBrequestsync\fR looks at the versions of <source package> in Debian and
Ubuntu and prompts for an explanation of why the Ubuntu changes (if there
are any) should be dropped.
The changelog entry is then downloaded from packages.debian.org, followed by
a prompt for your GPG passphrase so that it can sign the mail and send it
off, to file a sync request in the form of a bug report in Launchpad.
.SH OPTIONS .SH OPTIONS
.PP .PP
Listed below are the command line options for requestsync: Listed below are the command line options for requestsync:
.TP .TP
.B \-n .B \-n
Specifies that the package is a new package, and requestsync should not attempt to look it up in Ubuntu since it will not exist. Specifies that the package is a new package, and requestsync should not
attempt to look it up in Ubuntu since it will not exist.
.TP .TP
.B \-s .B \-s
Specifies that you require sponsorship. Specifies that you require sponsorship.
You need this option if you are not a member of ubuntu-dev for universe or multiverse, or ubuntu-core-dev for main or restricted. You need this option if you are not a member of ubuntu-dev for universe or
multiverse, or ubuntu-core-dev for main or restricted.
.TP .TP
.B \-k \fI<keyid>\fR .B \-k \fI<keyid>\fR
Specifies your GPC key. Specifies your GPC key.
Can also be set with the line `\fIexport GPGKEY=<keyid>\fR' in Can also be set with the line `\fIexport GPGKEY=<keyid>\fR' in
.IR $HOME/.bashrc \fR. .IR $HOME/.bashrc .
.TP .TP
.B <source package> .B <source package>
This is the source package that you would like to be synced from Debian. This is the source package that you would like to be synced from Debian.
.TP .TP
.B <target release> .B <target release>
This is the release that you would like the source package to be synced into. This is the release that you would like the source package to be synced
This should always be the latest development release of Ubuntu, ie: gutsy. into.
This should always be the latest development release of Ubuntu, i.e.: hardy.
.TP .TP
.B [base version] .B [base version]
In some cases, the base version (where the Ubuntu package started differing from the Debian package) can not be automatically determined. In some cases, the base version (where the Ubuntu package started differing
from the Debian package) cannot be automatically determined.
Specify this option in this case. Specify this option in this case.
.SH AUTHOR .SH AUTHOR
.PP .PP
@ -39,5 +48,4 @@ This manual page was pieced together by Steve Kowalik.
It was then updated by Ryan Kavanagh to reflect additional features. It was then updated by Ryan Kavanagh to reflect additional features.
.SH SEE ALSO .SH SEE ALSO
.PP .PP
\fBrmadison\fP\fB(1)\fP .BR rmadison (1)
.UE

View File

@ -9,9 +9,10 @@ This manual page documents briefly the
command. command.
.PP .PP
.B submittodebian .B submittodebian
was created to help bridge a gap between Debian and Ubuntu, namely by making it trivially easy to submit your changes to a Debian package to the Debian bts. was created to help bridge a gap between Debian and Ubuntu, namely by making it trivially easy to submit your changes to a Debian package to the Debian bug tracking system.
.PP .PP
It expects to find the .dsc and diff.gz of the current version (which you likely just created) and the previous one in the parent directory. By examining debian/changelog it will extract the information it needs to: It expects to find the .dsc and diff.gz of the current version (which you likely just created) and the previous one in the parent directory.
By examining debian/changelog it will extract the information it needs to:
.PP .PP
1. Extract the debdiff containing your changes. 1. Extract the debdiff containing your changes.
.PP .PP

View File

@ -23,7 +23,8 @@ considered.
a script with the same name, by Martin Pitt <martin.pitt@ubuntu.com>. a script with the same name, by Martin Pitt <martin.pitt@ubuntu.com>.
.\" .\"
.SH SEE ALSO .SH SEE ALSO
\fBfind(1)\fR .BR find (1)
.\" .\"
.SH COPYRIGHT .SH COPYRIGHT
This manual page was written by Siegfried-Angel Gevatter Pujals (RainCT). It is released under the GNU General Public License, version 2 or later. This manual page was written by Siegfried-Angel Gevatter Pujals (RainCT).
It is released under the GNU General Public License, version 2 or later.