/head: changeset 45
Updated
This commit is contained in:
parent
6e64fe411c
commit
872fce5502
69
head/README
69
head/README
@ -191,3 +191,72 @@ Q. Can I synchronize multiple accounts with OfflineIMAP?
|
|||||||
A. Sure. Just name them all in the accounts line in the general
|
A. Sure. Just name them all in the accounts line in the general
|
||||||
section of the config file, and add a per-account section for each one.
|
section of the config file, and add a per-account section for each one.
|
||||||
|
|
||||||
|
--------------------------------------------------
|
||||||
|
|
||||||
|
Q. Do you support POP?
|
||||||
|
|
||||||
|
A. No. POP is not robust enough to do a completely reliable
|
||||||
|
multi-machine synchronization like OfflineIMAP can do. OfflineIMAP
|
||||||
|
will not support it.
|
||||||
|
|
||||||
|
--------------------------------------------------
|
||||||
|
|
||||||
|
Q. Do you support mailbox formats other than Maildir?
|
||||||
|
|
||||||
|
A. Not at present. There is no technical reason not to; just no
|
||||||
|
demand yet. Maildir is a superior format anyway.
|
||||||
|
|
||||||
|
--------------------------------------------------
|
||||||
|
|
||||||
|
Q. [technical] Why are your Maildir message filenames so huge?
|
||||||
|
|
||||||
|
A. OfflineIMAP has two relevant principles: 1) never modifying your
|
||||||
|
messages in any way and 2) ensuring 100% reliable synchronizations.
|
||||||
|
In order to do a reliable sync, OfflineIMAP must have a way to
|
||||||
|
uniquely identify each e-mail. Three pieces of information are
|
||||||
|
required to do this: your account name, the folder name, and the
|
||||||
|
message UID. The account name can be calculated from the path in
|
||||||
|
which your messages are. The folder name can usually be as well, BUT
|
||||||
|
some mail clients move messages between folders by simply moving the
|
||||||
|
file, leaving the name intact.
|
||||||
|
|
||||||
|
So, OfflineIMAP must store both a UID folder ID. The folder ID is
|
||||||
|
necessary so OfflineIMAP can detect a message moved to a different
|
||||||
|
folder. OfflineIMAP stores the UID (U= number) and an md5sum of the
|
||||||
|
foldername (FMD5= number) to facilitate this.
|
||||||
|
|
||||||
|
--------------------------------------------------
|
||||||
|
|
||||||
|
Q. Can you provide an example of using OfflineIMAP with Mutt and
|
||||||
|
multiple accounts?
|
||||||
|
|
||||||
|
A. Sure. I set it up to have a single Mail directory with additional
|
||||||
|
directories under that for each account. So, mkdir ~/Mail. Then,
|
||||||
|
in your ~/.offlineimaprc:
|
||||||
|
|
||||||
|
Set "accounts = Personal, Work"
|
||||||
|
|
||||||
|
Make sure you have a [Personal] and a [Work] section, with different
|
||||||
|
pathnames. Enable [mbnames].
|
||||||
|
|
||||||
|
In each account section, do something like this:
|
||||||
|
|
||||||
|
localfolders = ~/Mail/Personal
|
||||||
|
|
||||||
|
or
|
||||||
|
|
||||||
|
localfolders = ~/Mail/Work
|
||||||
|
|
||||||
|
In Mutt:
|
||||||
|
|
||||||
|
add lines like this to your ~/.muttrc:
|
||||||
|
|
||||||
|
source ~/path-to-mbnames-muttrc-mailboxes
|
||||||
|
|
||||||
|
folder-hook Personal set from="youremail@personal.com"
|
||||||
|
folder-hook Work set from="youremail@work.com"
|
||||||
|
set mbox_type=Maildir
|
||||||
|
set folder=$HOME/Mail
|
||||||
|
set spoolfile=+Personal/INBOX
|
||||||
|
|
||||||
|
That's it!
|
||||||
|
6
head/debian/README
Normal file
6
head/debian/README
Normal file
@ -0,0 +1,6 @@
|
|||||||
|
The Debian Package offlineimap
|
||||||
|
----------------------------
|
||||||
|
|
||||||
|
Comments regarding the Package
|
||||||
|
|
||||||
|
John Goerzen <jgoerzen@complete.org>, Fri, 21 Jun 2002 14:54:56 -0500
|
6
head/debian/README.Debian
Normal file
6
head/debian/README.Debian
Normal file
@ -0,0 +1,6 @@
|
|||||||
|
offlineimap for Debian
|
||||||
|
----------------------
|
||||||
|
|
||||||
|
<possible notes regarding this package - if none, delete this file>
|
||||||
|
|
||||||
|
-- John Goerzen <jgoerzen@complete.org>, Fri, 21 Jun 2002 14:54:56 -0500
|
9
head/debian/changelog
Normal file
9
head/debian/changelog
Normal file
@ -0,0 +1,9 @@
|
|||||||
|
offlineimap (1.0.0) unstable; urgency=low
|
||||||
|
|
||||||
|
* Initial Release.
|
||||||
|
|
||||||
|
-- John Goerzen <jgoerzen@complete.org> Fri, 21 Jun 2002 14:54:56 -0500
|
||||||
|
|
||||||
|
Local variables:
|
||||||
|
mode: debian-changelog
|
||||||
|
End:
|
7
head/debian/conffiles.ex
Normal file
7
head/debian/conffiles.ex
Normal file
@ -0,0 +1,7 @@
|
|||||||
|
#
|
||||||
|
# If you want to use this conffile, remove all comments and put files that
|
||||||
|
# you want dpkg to process here using their absolute pathnames.
|
||||||
|
# See the policy manual
|
||||||
|
#
|
||||||
|
# for example:
|
||||||
|
# /etc/offlineimap/offlineimap.conf
|
12
head/debian/control
Normal file
12
head/debian/control
Normal file
@ -0,0 +1,12 @@
|
|||||||
|
Source: offlineimap
|
||||||
|
Section: unknown
|
||||||
|
Priority: optional
|
||||||
|
Maintainer: John Goerzen <jgoerzen@complete.org>
|
||||||
|
Build-Depends: debhelper (>> 3.0.0)
|
||||||
|
Standards-Version: 3.5.2
|
||||||
|
|
||||||
|
Package: offlineimap
|
||||||
|
Architecture: any
|
||||||
|
Depends: ${shlibs:Depends}
|
||||||
|
Description: <insert up to 60 chars description>
|
||||||
|
<insert long description, indented with spaces>
|
22
head/debian/copyright
Normal file
22
head/debian/copyright
Normal file
@ -0,0 +1,22 @@
|
|||||||
|
This is offlineimap, written and maintained by John Goerzen <jgoerzen@complete.org>
|
||||||
|
on Fri, 21 Jun 2002 14:54:56 -0500.
|
||||||
|
|
||||||
|
The original source can always be found at:
|
||||||
|
ftp://ftp.debian.org/dists/unstable/main/source/
|
||||||
|
|
||||||
|
Copyright (C) 2002 John Goerzen
|
||||||
|
|
||||||
|
This program is free software; you can redistribute it and/or modify
|
||||||
|
it under the terms of the GNU General Public License as published by
|
||||||
|
the Free Software Foundation; either version 2 of the License, or
|
||||||
|
(at your option) any later version.
|
||||||
|
|
||||||
|
This program is distributed in the hope that it will be useful,
|
||||||
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||||
|
GNU General Public License for more details.
|
||||||
|
|
||||||
|
You should have received a copy of the GNU General Public License with
|
||||||
|
the Debian GNU/Linux distribution in file /usr/share/common-licenses/GPL;
|
||||||
|
if not, write to the Free Software Foundation, Inc., 59 Temple Place,
|
||||||
|
Suite 330, Boston, MA 02111-1307 USA
|
4
head/debian/cron.d.ex
Normal file
4
head/debian/cron.d.ex
Normal file
@ -0,0 +1,4 @@
|
|||||||
|
#
|
||||||
|
# Regular cron jobs for the offlineimap package
|
||||||
|
#
|
||||||
|
0 4 * * * root offlineimap_maintenance
|
2
head/debian/dirs
Normal file
2
head/debian/dirs
Normal file
@ -0,0 +1,2 @@
|
|||||||
|
usr/bin
|
||||||
|
usr/sbin
|
2
head/debian/docs
Normal file
2
head/debian/docs
Normal file
@ -0,0 +1,2 @@
|
|||||||
|
README
|
||||||
|
README~
|
45
head/debian/emacsen-install.ex
Normal file
45
head/debian/emacsen-install.ex
Normal file
@ -0,0 +1,45 @@
|
|||||||
|
#! /bin/sh -e
|
||||||
|
# /usr/lib/emacsen-common/packages/install/offlineimap
|
||||||
|
|
||||||
|
# Written by Jim Van Zandt <jrv@vanzandt.mv.com>, borrowing heavily
|
||||||
|
# from the install scripts for gettext by Santiago Vila
|
||||||
|
# <sanvila@ctv.es> and octave by Dirk Eddelbuettel <edd@debian.org>.
|
||||||
|
|
||||||
|
FLAVOR=$1
|
||||||
|
PACKAGE=offlineimap
|
||||||
|
|
||||||
|
if [ ${FLAVOR} = emacs ]; then exit 0; fi
|
||||||
|
|
||||||
|
echo install/${PACKAGE}: Handling install for emacsen flavor ${FLAVOR}
|
||||||
|
|
||||||
|
#FLAVORTEST=`echo $FLAVOR | cut -c-6`
|
||||||
|
#if [ ${FLAVORTEST} = xemacs ] ; then
|
||||||
|
# SITEFLAG="-no-site-file"
|
||||||
|
#else
|
||||||
|
# SITEFLAG="--no-site-file"
|
||||||
|
#fi
|
||||||
|
FLAGS="${SITEFLAG} -q -batch -l path.el -f batch-byte-compile"
|
||||||
|
|
||||||
|
ELDIR=/usr/share/emacs/site-lisp/${PACKAGE}
|
||||||
|
ELCDIR=/usr/share/${FLAVOR}/site-lisp/${PACKAGE}
|
||||||
|
|
||||||
|
# Install-info-altdir does not actually exist.
|
||||||
|
# Maybe somebody will write it.
|
||||||
|
if test -x /usr/sbin/install-info-altdir; then
|
||||||
|
echo install/${PACKAGE}: install Info links for ${FLAVOR}
|
||||||
|
install-info-altdir --quiet --section "" "" --dirname=${FLAVOR} /usr/info/${PACKAGE}.info.gz
|
||||||
|
fi
|
||||||
|
|
||||||
|
install -m 755 -d ${ELCDIR}
|
||||||
|
cd ${ELDIR}
|
||||||
|
FILES=`echo *.el`
|
||||||
|
cp ${FILES} ${ELCDIR}
|
||||||
|
cd ${ELCDIR}
|
||||||
|
|
||||||
|
cat << EOF > path.el
|
||||||
|
(setq load-path (cons "." load-path) byte-compile-warnings nil)
|
||||||
|
EOF
|
||||||
|
${FLAVOR} ${FLAGS} ${FILES}
|
||||||
|
rm -f *.el path.el
|
||||||
|
|
||||||
|
exit 0
|
15
head/debian/emacsen-remove.ex
Normal file
15
head/debian/emacsen-remove.ex
Normal file
@ -0,0 +1,15 @@
|
|||||||
|
#!/bin/sh -e
|
||||||
|
# /usr/lib/emacsen-common/packages/remove/offlineimap
|
||||||
|
|
||||||
|
FLAVOR=$1
|
||||||
|
PACKAGE=offlineimap
|
||||||
|
|
||||||
|
if [ ${FLAVOR} != emacs ]; then
|
||||||
|
if test -x /usr/sbin/install-info-altdir; then
|
||||||
|
echo remove/${PACKAGE}: removing Info links for ${FLAVOR}
|
||||||
|
install-info-altdir --quiet --remove --dirname=${FLAVOR} /usr/info/offlineimap.info.gz
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo remove/${PACKAGE}: purging byte-compiled files for ${FLAVOR}
|
||||||
|
rm -rf /usr/share/${FLAVOR}/site-lisp/${PACKAGE}
|
||||||
|
fi
|
18
head/debian/emacsen-startup.ex
Normal file
18
head/debian/emacsen-startup.ex
Normal file
@ -0,0 +1,18 @@
|
|||||||
|
;; -*-emacs-lisp-*-
|
||||||
|
;;
|
||||||
|
;; Emacs startup file for the Debian GNU/Linux offlineimap package
|
||||||
|
;;
|
||||||
|
;; Originally contributed by Nils Naumann <naumann@unileoben.ac.at>
|
||||||
|
;; Modified by Dirk Eddelbuettel <edd@debian.org>
|
||||||
|
;; Adapted for dh-make by Jim Van Zandt <jrv@vanzandt.mv.com>
|
||||||
|
|
||||||
|
;; The offlineimap package follows the Debian/GNU Linux 'emacsen' policy and
|
||||||
|
;; byte-compiles its elisp files for each 'emacs flavor' (emacs19,
|
||||||
|
;; xemacs19, emacs20, xemacs20...). The compiled code is then
|
||||||
|
;; installed in a subdirectory of the respective site-lisp directory.
|
||||||
|
;; We have to add this to the load-path:
|
||||||
|
(setq load-path (cons (concat "/usr/share/"
|
||||||
|
(symbol-name flavor)
|
||||||
|
"/site-lisp/offlineimap") load-path))
|
||||||
|
|
||||||
|
|
22
head/debian/ex.package.doc-base
Normal file
22
head/debian/ex.package.doc-base
Normal file
@ -0,0 +1,22 @@
|
|||||||
|
Document: offlineimap
|
||||||
|
Title: Debian offlineimap Manual
|
||||||
|
Author: <insert document author here>
|
||||||
|
Abstract: This manual describes what offlineimap is
|
||||||
|
and how it can be used to
|
||||||
|
manage online manuals on Debian systems.
|
||||||
|
Section: unknown
|
||||||
|
|
||||||
|
Format: debiandoc-sgml
|
||||||
|
Files: /usr/share/doc/offlineimap/offlineimap.sgml.gz
|
||||||
|
|
||||||
|
Format: postscript
|
||||||
|
Files: /usr/share/doc/offlineimap/offlineimap.ps.gz
|
||||||
|
|
||||||
|
Format: text
|
||||||
|
Files: /usr/share/doc/offlineimap/offlineimap.text.gz
|
||||||
|
|
||||||
|
Format: HTML
|
||||||
|
Index: /usr/share/doc/offlineimap/html/index.html
|
||||||
|
Files: /usr/share/doc/offlineimap/html/*.html
|
||||||
|
|
||||||
|
|
70
head/debian/init.d.ex
Normal file
70
head/debian/init.d.ex
Normal file
@ -0,0 +1,70 @@
|
|||||||
|
#! /bin/sh
|
||||||
|
#
|
||||||
|
# skeleton example file to build /etc/init.d/ scripts.
|
||||||
|
# This file should be used to construct scripts for /etc/init.d.
|
||||||
|
#
|
||||||
|
# Written by Miquel van Smoorenburg <miquels@cistron.nl>.
|
||||||
|
# Modified for Debian GNU/Linux
|
||||||
|
# by Ian Murdock <imurdock@gnu.ai.mit.edu>.
|
||||||
|
#
|
||||||
|
# Version: @(#)skeleton 1.8 03-Mar-1998 miquels@cistron.nl
|
||||||
|
#
|
||||||
|
# This file was automatically customized by dh-make on Fri, 21 Jun 2002 14:54:56 -0500
|
||||||
|
|
||||||
|
PATH=/sbin:/bin:/usr/sbin:/usr/bin
|
||||||
|
DAEMON=/usr/sbin/offlineimap
|
||||||
|
NAME=offlineimap
|
||||||
|
DESC=offlineimap
|
||||||
|
|
||||||
|
test -f $DAEMON || exit 0
|
||||||
|
|
||||||
|
set -e
|
||||||
|
|
||||||
|
case "$1" in
|
||||||
|
start)
|
||||||
|
echo -n "Starting $DESC: "
|
||||||
|
start-stop-daemon --start --quiet --pidfile /var/run/$NAME.pid \
|
||||||
|
--exec $DAEMON
|
||||||
|
echo "$NAME."
|
||||||
|
;;
|
||||||
|
stop)
|
||||||
|
echo -n "Stopping $DESC: "
|
||||||
|
start-stop-daemon --oknodo --stop --quiet --pidfile /var/run/$NAME.pid \
|
||||||
|
--exec $DAEMON
|
||||||
|
echo "$NAME."
|
||||||
|
;;
|
||||||
|
#reload)
|
||||||
|
#
|
||||||
|
# If the daemon can reload its config files on the fly
|
||||||
|
# for example by sending it SIGHUP, do it here.
|
||||||
|
#
|
||||||
|
# If the daemon responds to changes in its config file
|
||||||
|
# directly anyway, make this a do-nothing entry.
|
||||||
|
#
|
||||||
|
# echo "Reloading $DESC configuration files."
|
||||||
|
# start-stop-daemon --stop --signal 1 --quiet --pidfile \
|
||||||
|
# /var/run/$NAME.pid --exec $DAEMON
|
||||||
|
#;;
|
||||||
|
restart|force-reload)
|
||||||
|
#
|
||||||
|
# If the "reload" option is implemented, move the "force-reload"
|
||||||
|
# option to the "reload" entry above. If not, "force-reload" is
|
||||||
|
# just the same as "restart".
|
||||||
|
#
|
||||||
|
echo -n "Restarting $DESC: "
|
||||||
|
start-stop-daemon --stop --quiet --pidfile \
|
||||||
|
/var/run/$NAME.pid --exec $DAEMON
|
||||||
|
sleep 1
|
||||||
|
start-stop-daemon --start --quiet --pidfile \
|
||||||
|
/var/run/$NAME.pid --exec $DAEMON
|
||||||
|
echo "$NAME."
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
N=/etc/init.d/$NAME
|
||||||
|
# echo "Usage: $N {start|stop|restart|reload|force-reload}" >&2
|
||||||
|
echo "Usage: $N {start|stop|restart|force-reload}" >&2
|
||||||
|
exit 1
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
exit 0
|
60
head/debian/manpage.1.ex
Normal file
60
head/debian/manpage.1.ex
Normal file
@ -0,0 +1,60 @@
|
|||||||
|
.\" Hey, EMACS: -*- nroff -*-
|
||||||
|
.\" First parameter, NAME, should be all caps
|
||||||
|
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
|
||||||
|
.\" other parameters are allowed: see man(7), man(1)
|
||||||
|
.TH OFFLINEIMAP SECTION "June 21, 2002"
|
||||||
|
.\" Please adjust this date whenever revising the manpage.
|
||||||
|
.\"
|
||||||
|
.\" Some roff macros, for reference:
|
||||||
|
.\" .nh disable hyphenation
|
||||||
|
.\" .hy enable hyphenation
|
||||||
|
.\" .ad l left justify
|
||||||
|
.\" .ad b justify to both left and right margins
|
||||||
|
.\" .nf disable filling
|
||||||
|
.\" .fi enable filling
|
||||||
|
.\" .br insert line break
|
||||||
|
.\" .sp <n> insert n+1 empty lines
|
||||||
|
.\" for manpage-specific macros, see man(7)
|
||||||
|
.SH NAME
|
||||||
|
offlineimap \- program to do something
|
||||||
|
.SH SYNOPSIS
|
||||||
|
.B offlineimap
|
||||||
|
.RI [ options ] " files" ...
|
||||||
|
.br
|
||||||
|
.B bar
|
||||||
|
.RI [ options ] " files" ...
|
||||||
|
.SH DESCRIPTION
|
||||||
|
This manual page documents briefly the
|
||||||
|
.B offlineimap
|
||||||
|
and
|
||||||
|
.B bar
|
||||||
|
commands.
|
||||||
|
This manual page was written for the Debian distribution
|
||||||
|
because the original program does not have a manual page.
|
||||||
|
Instead, it has documentation in the GNU Info format; see below.
|
||||||
|
.PP
|
||||||
|
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
|
||||||
|
.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
|
||||||
|
.\" respectively.
|
||||||
|
\fBofflineimap\fP is a program that...
|
||||||
|
.SH OPTIONS
|
||||||
|
These programs follow the usual GNU command line syntax, with long
|
||||||
|
options starting with two dashes (`-').
|
||||||
|
A summary of options is included below.
|
||||||
|
For a complete description, see the Info files.
|
||||||
|
.TP
|
||||||
|
.B \-h, \-\-help
|
||||||
|
Show summary of options.
|
||||||
|
.TP
|
||||||
|
.B \-v, \-\-version
|
||||||
|
Show version of program.
|
||||||
|
.SH SEE ALSO
|
||||||
|
.BR bar (1),
|
||||||
|
.BR baz (1).
|
||||||
|
.br
|
||||||
|
The programs are documented fully by
|
||||||
|
.IR "The Rise and Fall of a Fooish Bar" ,
|
||||||
|
available via the Info system.
|
||||||
|
.SH AUTHOR
|
||||||
|
This manual page was written by John Goerzen <jgoerzen@complete.org>,
|
||||||
|
for the Debian GNU/Linux system (but may be used by others).
|
152
head/debian/manpage.sgml.ex
Normal file
152
head/debian/manpage.sgml.ex
Normal file
@ -0,0 +1,152 @@
|
|||||||
|
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
|
||||||
|
|
||||||
|
<!-- Process this file with docbook-to-man to generate an nroff manual
|
||||||
|
page: `docbook-to-man manpage.sgml > manpage.1'. You may view
|
||||||
|
the manual page with: `docbook-to-man manpage.sgml | nroff -man |
|
||||||
|
less'. A typical entry in a Makefile or Makefile.am is:
|
||||||
|
|
||||||
|
manpage.1: manpage.sgml
|
||||||
|
docbook-to-man $< > $@
|
||||||
|
|
||||||
|
|
||||||
|
The docbook-to-man binary is found in the docbook-to-man package.
|
||||||
|
Please remember that if you create the nroff version in one of the
|
||||||
|
debian/rules file targets (such as build), you will need to include
|
||||||
|
docbook-to-man in your Build-Depends control field.
|
||||||
|
|
||||||
|
-->
|
||||||
|
|
||||||
|
<!-- Fill in your name for FIRSTNAME and SURNAME. -->
|
||||||
|
<!ENTITY dhfirstname "<firstname>FIRSTNAME</firstname>">
|
||||||
|
<!ENTITY dhsurname "<surname>SURNAME</surname>">
|
||||||
|
<!-- Please adjust the date whenever revising the manpage. -->
|
||||||
|
<!ENTITY dhdate "<date>June 21, 2002</date>">
|
||||||
|
<!-- SECTION should be 1-8, maybe w/ subsection other parameters are
|
||||||
|
allowed: see man(7), man(1). -->
|
||||||
|
<!ENTITY dhsection "<manvolnum>SECTION</manvolnum>">
|
||||||
|
<!ENTITY dhemail "<email>jgoerzen@complete.org</email>">
|
||||||
|
<!ENTITY dhusername "John Goerzen">
|
||||||
|
<!ENTITY dhucpackage "<refentrytitle>OFFLINEIMAP</refentrytitle>">
|
||||||
|
<!ENTITY dhpackage "offlineimap">
|
||||||
|
|
||||||
|
<!ENTITY debian "<productname>Debian</productname>">
|
||||||
|
<!ENTITY gnu "<acronym>GNU</acronym>">
|
||||||
|
]>
|
||||||
|
|
||||||
|
<refentry>
|
||||||
|
<refentryinfo>
|
||||||
|
<address>
|
||||||
|
&dhemail;
|
||||||
|
</address>
|
||||||
|
<author>
|
||||||
|
&dhfirstname;
|
||||||
|
&dhsurname;
|
||||||
|
</author>
|
||||||
|
<copyright>
|
||||||
|
<year>2001</year>
|
||||||
|
<holder>&dhusername;</holder>
|
||||||
|
</copyright>
|
||||||
|
&dhdate;
|
||||||
|
</refentryinfo>
|
||||||
|
<refmeta>
|
||||||
|
&dhucpackage;
|
||||||
|
|
||||||
|
&dhsection;
|
||||||
|
</refmeta>
|
||||||
|
<refnamediv>
|
||||||
|
<refname>&dhpackage;</refname>
|
||||||
|
|
||||||
|
<refpurpose>program to do something</refpurpose>
|
||||||
|
</refnamediv>
|
||||||
|
<refsynopsisdiv>
|
||||||
|
<cmdsynopsis>
|
||||||
|
<command>&dhpackage;</command>
|
||||||
|
|
||||||
|
<arg><option>-e <replaceable>this</replaceable></option></arg>
|
||||||
|
|
||||||
|
<arg><option>--example <replaceable>that</replaceable></option></arg>
|
||||||
|
</cmdsynopsis>
|
||||||
|
</refsynopsisdiv>
|
||||||
|
<refsect1>
|
||||||
|
<title>DESCRIPTION</title>
|
||||||
|
|
||||||
|
<para>This manual page documents briefly the
|
||||||
|
<command>&dhpackage;</command> and <command>bar</command>
|
||||||
|
commands.</para>
|
||||||
|
|
||||||
|
<para>This manual page was written for the &debian; distribution
|
||||||
|
because the original program does not have a manual page.
|
||||||
|
Instead, it has documentation in the &gnu;
|
||||||
|
<application>Info</application> format; see below.</para>
|
||||||
|
|
||||||
|
<para><command>&dhpackage;</command> is a program that...</para>
|
||||||
|
|
||||||
|
</refsect1>
|
||||||
|
<refsect1>
|
||||||
|
<title>OPTIONS</title>
|
||||||
|
|
||||||
|
<para>These programs follow the usual GNU command line syntax,
|
||||||
|
with long options starting with two dashes (`-'). A summary of
|
||||||
|
options is included below. For a complete description, see the
|
||||||
|
<application>Info</application> files.</para>
|
||||||
|
|
||||||
|
<variablelist>
|
||||||
|
<varlistentry>
|
||||||
|
<term><option>-h</option>
|
||||||
|
<option>--help</option>
|
||||||
|
</term>
|
||||||
|
<listitem>
|
||||||
|
<para>Show summary of options.</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
<varlistentry>
|
||||||
|
<term><option>-v</option>
|
||||||
|
<option>--version</option>
|
||||||
|
</term>
|
||||||
|
<listitem>
|
||||||
|
<para>Show version of program.</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
</variablelist>
|
||||||
|
</refsect1>
|
||||||
|
<refsect1>
|
||||||
|
<title>SEE ALSO</title>
|
||||||
|
|
||||||
|
<para>bar (1), baz (1).</para>
|
||||||
|
|
||||||
|
<para>The programs are documented fully by <citetitle>The Rise and
|
||||||
|
Fall of a Fooish Bar</citetitle> available via the
|
||||||
|
<application>Info</application> system.</para>
|
||||||
|
</refsect1>
|
||||||
|
<refsect1>
|
||||||
|
<title>AUTHOR</title>
|
||||||
|
|
||||||
|
<para>This manual page was written by &dhusername; &dhemail; for
|
||||||
|
the &debian; system (but may be used by others). Permission is
|
||||||
|
granted to copy, distribute and/or modify this document under
|
||||||
|
the terms of the <acronym>GNU</acronym> Free Documentation
|
||||||
|
License, Version 1.1 or any later version published by the Free
|
||||||
|
Software Foundation; with no Invariant Sections, no Front-Cover
|
||||||
|
Texts and no Back-Cover Texts.</para>
|
||||||
|
|
||||||
|
</refsect1>
|
||||||
|
</refentry>
|
||||||
|
|
||||||
|
<!-- Keep this comment at the end of the file
|
||||||
|
Local variables:
|
||||||
|
mode: sgml
|
||||||
|
sgml-omittag:t
|
||||||
|
sgml-shorttag:t
|
||||||
|
sgml-minimize-attributes:nil
|
||||||
|
sgml-always-quote-attributes:t
|
||||||
|
sgml-indent-step:2
|
||||||
|
sgml-indent-data:t
|
||||||
|
sgml-parent-document:nil
|
||||||
|
sgml-default-dtd-file:nil
|
||||||
|
sgml-exposed-tags:nil
|
||||||
|
sgml-local-catalogs:nil
|
||||||
|
sgml-local-ecat-files:nil
|
||||||
|
End:
|
||||||
|
-->
|
||||||
|
|
||||||
|
|
2
head/debian/menu.ex
Normal file
2
head/debian/menu.ex
Normal file
@ -0,0 +1,2 @@
|
|||||||
|
?package(offlineimap):needs=X11|text|vc|wm section=Apps/see-menu-manual\
|
||||||
|
title="offlineimap" command="/usr/bin/offlineimap"
|
48
head/debian/postinst.ex
Normal file
48
head/debian/postinst.ex
Normal file
@ -0,0 +1,48 @@
|
|||||||
|
#! /bin/sh
|
||||||
|
# postinst script for offlineimap
|
||||||
|
#
|
||||||
|
# see: dh_installdeb(1)
|
||||||
|
|
||||||
|
set -e
|
||||||
|
|
||||||
|
# summary of how this script can be called:
|
||||||
|
# * <postinst> `configure' <most-recently-configured-version>
|
||||||
|
# * <old-postinst> `abort-upgrade' <new version>
|
||||||
|
# * <conflictor's-postinst> `abort-remove' `in-favour' <package>
|
||||||
|
# <new-version>
|
||||||
|
# * <deconfigured's-postinst> `abort-deconfigure' `in-favour'
|
||||||
|
# <failed-install-package> <version> `removing'
|
||||||
|
# <conflicting-package> <version>
|
||||||
|
# for details, see http://www.debian.org/doc/debian-policy/ or
|
||||||
|
# the debian-policy package
|
||||||
|
#
|
||||||
|
# quoting from the policy:
|
||||||
|
# Any necessary prompting should almost always be confined to the
|
||||||
|
# post-installation script, and should be protected with a conditional
|
||||||
|
# so that unnecessary prompting doesn't happen if a package's
|
||||||
|
# installation fails and the `postinst' is called with `abort-upgrade',
|
||||||
|
# `abort-remove' or `abort-deconfigure'.
|
||||||
|
|
||||||
|
case "$1" in
|
||||||
|
configure)
|
||||||
|
|
||||||
|
;;
|
||||||
|
|
||||||
|
abort-upgrade|abort-remove|abort-deconfigure)
|
||||||
|
|
||||||
|
;;
|
||||||
|
|
||||||
|
*)
|
||||||
|
echo "postinst called with unknown argument \`$1'" >&2
|
||||||
|
exit 1
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
# dh_installdeb will replace this with shell code automatically
|
||||||
|
# generated by other debhelper scripts.
|
||||||
|
|
||||||
|
#DEBHELPER#
|
||||||
|
|
||||||
|
exit 0
|
||||||
|
|
||||||
|
|
38
head/debian/postrm.ex
Normal file
38
head/debian/postrm.ex
Normal file
@ -0,0 +1,38 @@
|
|||||||
|
#! /bin/sh
|
||||||
|
# postrm script for offlineimap
|
||||||
|
#
|
||||||
|
# see: dh_installdeb(1)
|
||||||
|
|
||||||
|
set -e
|
||||||
|
|
||||||
|
# summary of how this script can be called:
|
||||||
|
# * <postrm> `remove'
|
||||||
|
# * <postrm> `purge'
|
||||||
|
# * <old-postrm> `upgrade' <new-version>
|
||||||
|
# * <new-postrm> `failed-upgrade' <old-version>
|
||||||
|
# * <new-postrm> `abort-install'
|
||||||
|
# * <new-postrm> `abort-install' <old-version>
|
||||||
|
# * <new-postrm> `abort-upgrade' <old-version>
|
||||||
|
# * <disappearer's-postrm> `disappear' <r>overwrit>r> <new-version>
|
||||||
|
# for details, see http://www.debian.org/doc/debian-policy/ or
|
||||||
|
# the debian-policy package
|
||||||
|
|
||||||
|
|
||||||
|
case "$1" in
|
||||||
|
purge|remove|upgrade|failed-upgrade|abort-install|abort-upgrade|disappear)
|
||||||
|
|
||||||
|
|
||||||
|
;;
|
||||||
|
|
||||||
|
*)
|
||||||
|
echo "postrm called with unknown argument \`$1'" >&2
|
||||||
|
exit 1
|
||||||
|
|
||||||
|
esac
|
||||||
|
|
||||||
|
# dh_installdeb will replace this with shell code automatically
|
||||||
|
# generated by other debhelper scripts.
|
||||||
|
|
||||||
|
#DEBHELPER#
|
||||||
|
|
||||||
|
exit 0
|
44
head/debian/preinst.ex
Normal file
44
head/debian/preinst.ex
Normal file
@ -0,0 +1,44 @@
|
|||||||
|
#! /bin/sh
|
||||||
|
# preinst script for offlineimap
|
||||||
|
#
|
||||||
|
# see: dh_installdeb(1)
|
||||||
|
|
||||||
|
set -e
|
||||||
|
|
||||||
|
# summary of how this script can be called:
|
||||||
|
# * <new-preinst> `install'
|
||||||
|
# * <new-preinst> `install' <old-version>
|
||||||
|
# * <new-preinst> `upgrade' <old-version>
|
||||||
|
# * <old-preinst> `abort-upgrade' <new-version>
|
||||||
|
#
|
||||||
|
# for details, see http://www.debian.org/doc/debian-policy/ or
|
||||||
|
# the debian-policy package
|
||||||
|
|
||||||
|
|
||||||
|
case "$1" in
|
||||||
|
install|upgrade)
|
||||||
|
# if [ "$1" = "upgrade" ]
|
||||||
|
# then
|
||||||
|
# start-stop-daemon --stop --quiet --oknodo \
|
||||||
|
# --pidfile /var/run/offlineimap.pid \
|
||||||
|
# --exec /usr/sbin/offlineimap 2>/dev/null || true
|
||||||
|
# fi
|
||||||
|
;;
|
||||||
|
|
||||||
|
abort-upgrade)
|
||||||
|
;;
|
||||||
|
|
||||||
|
*)
|
||||||
|
echo "preinst called with unknown argument \`$1'" >&2
|
||||||
|
exit 1
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
# dh_installdeb will replace this with shell code automatically
|
||||||
|
# generated by other debhelper scripts.
|
||||||
|
|
||||||
|
#DEBHELPER#
|
||||||
|
|
||||||
|
exit 0
|
||||||
|
|
||||||
|
|
39
head/debian/prerm.ex
Normal file
39
head/debian/prerm.ex
Normal file
@ -0,0 +1,39 @@
|
|||||||
|
#! /bin/sh
|
||||||
|
# prerm script for offlineimap
|
||||||
|
#
|
||||||
|
# see: dh_installdeb(1)
|
||||||
|
|
||||||
|
set -e
|
||||||
|
|
||||||
|
# summary of how this script can be called:
|
||||||
|
# * <prerm> `remove'
|
||||||
|
# * <old-prerm> `upgrade' <new-version>
|
||||||
|
# * <new-prerm> `failed-upgrade' <old-version>
|
||||||
|
# * <conflictor's-prerm> `remove' `in-favour' <package> <new-version>
|
||||||
|
# * <deconfigured's-prerm> `deconfigure' `in-favour'
|
||||||
|
# <package-being-installed> <version> `removing'
|
||||||
|
# <conflicting-package> <version>
|
||||||
|
# for details, see http://www.debian.org/doc/debian-policy/ or
|
||||||
|
# the debian-policy package
|
||||||
|
|
||||||
|
|
||||||
|
case "$1" in
|
||||||
|
remove|upgrade|deconfigure)
|
||||||
|
# install-info --quiet --remove /usr/info/offlineimap.info.gz
|
||||||
|
;;
|
||||||
|
failed-upgrade)
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
echo "prerm called with unknown argument \`$1'" >&2
|
||||||
|
exit 1
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
# dh_installdeb will replace this with shell code automatically
|
||||||
|
# generated by other debhelper scripts.
|
||||||
|
|
||||||
|
#DEBHELPER#
|
||||||
|
|
||||||
|
exit 0
|
||||||
|
|
||||||
|
|
94
head/debian/rules
Normal file
94
head/debian/rules
Normal file
@ -0,0 +1,94 @@
|
|||||||
|
#!/usr/bin/make -f
|
||||||
|
# Sample debian/rules that uses debhelper.
|
||||||
|
# GNU copyright 1997 to 1999 by Joey Hess.
|
||||||
|
|
||||||
|
# Uncomment this to turn on verbose mode.
|
||||||
|
#export DH_VERBOSE=1
|
||||||
|
|
||||||
|
# This is the debhelper compatibility version to use.
|
||||||
|
export DH_COMPAT=3
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
ifneq (,$(findstring debug,$(DEB_BUILD_OPTIONS)))
|
||||||
|
CFLAGS += -g
|
||||||
|
endif
|
||||||
|
ifeq (,$(findstring nostrip,$(DEB_BUILD_OPTIONS)))
|
||||||
|
INSTALL_PROGRAM += -s
|
||||||
|
endif
|
||||||
|
|
||||||
|
configure: configure-stamp
|
||||||
|
configure-stamp:
|
||||||
|
dh_testdir
|
||||||
|
# Add here commands to configure the package.
|
||||||
|
|
||||||
|
touch configure-stamp
|
||||||
|
|
||||||
|
|
||||||
|
build: build-stamp
|
||||||
|
|
||||||
|
build-stamp: configure-stamp
|
||||||
|
dh_testdir
|
||||||
|
|
||||||
|
# Add here commands to compile the package.
|
||||||
|
$(MAKE)
|
||||||
|
#/usr/bin/docbook-to-man debian/offlineimap.sgml > offlineimap.1
|
||||||
|
|
||||||
|
touch build-stamp
|
||||||
|
|
||||||
|
clean:
|
||||||
|
dh_testdir
|
||||||
|
dh_testroot
|
||||||
|
rm -f build-stamp configure-stamp
|
||||||
|
|
||||||
|
# Add here commands to clean up after the build process.
|
||||||
|
-$(MAKE) clean
|
||||||
|
|
||||||
|
dh_clean
|
||||||
|
|
||||||
|
install: build
|
||||||
|
dh_testdir
|
||||||
|
dh_testroot
|
||||||
|
dh_clean -k
|
||||||
|
dh_installdirs
|
||||||
|
|
||||||
|
# Add here commands to install the package into debian/offlineimap.
|
||||||
|
$(MAKE) install DESTDIR=$(CURDIR)/debian/offlineimap
|
||||||
|
|
||||||
|
|
||||||
|
# Build architecture-independent files here.
|
||||||
|
binary-indep: build install
|
||||||
|
# We have nothing to do by default.
|
||||||
|
|
||||||
|
# Build architecture-dependent files here.
|
||||||
|
binary-arch: build install
|
||||||
|
dh_testdir
|
||||||
|
dh_testroot
|
||||||
|
# dh_installdebconf
|
||||||
|
dh_installdocs
|
||||||
|
dh_installexamples
|
||||||
|
dh_installmenu
|
||||||
|
# dh_installlogrotate
|
||||||
|
# dh_installemacsen
|
||||||
|
# dh_installpam
|
||||||
|
# dh_installmime
|
||||||
|
# dh_installinit
|
||||||
|
dh_installcron
|
||||||
|
dh_installman
|
||||||
|
dh_installinfo
|
||||||
|
# dh_undocumented
|
||||||
|
dh_installchangelogs ChangeLog
|
||||||
|
dh_link
|
||||||
|
dh_strip
|
||||||
|
dh_compress
|
||||||
|
dh_fixperms
|
||||||
|
# dh_makeshlibs
|
||||||
|
dh_installdeb
|
||||||
|
# dh_perl
|
||||||
|
dh_shlibdeps
|
||||||
|
dh_gencontrol
|
||||||
|
dh_md5sums
|
||||||
|
dh_builddeb
|
||||||
|
|
||||||
|
binary: binary-indep binary-arch
|
||||||
|
.PHONY: build clean binary-indep binary-arch binary install configure
|
5
head/debian/watch.ex
Normal file
5
head/debian/watch.ex
Normal file
@ -0,0 +1,5 @@
|
|||||||
|
# Example watch control file for uscan
|
||||||
|
# Rename this file to "watch" and then you can run the "uscan" command
|
||||||
|
# to check for upstream updates and more.
|
||||||
|
# Site Directory Pattern Version Script
|
||||||
|
sunsite.unc.edu /pub/Linux/Incoming offlineimap-(.*)\.tar\.gz debian uupdate
|
Loading…
Reference in New Issue
Block a user