From b1696a55c38a1838ca25ebad58cd5b9ad48a9b75 Mon Sep 17 00:00:00 2001 From: "Paul C. Buetow (mars.fritz.box)" Date: Fri, 4 Jul 2014 21:48:08 +0200 Subject: rename --- Makefile | 2 +- README.pod | 44 ++++---- debian/README | 2 +- debian/changelog | 4 +- debian/control | 15 +-- debian/copyright | 4 +- debian/files | 2 +- debian/muttdelay.manpages | 1 + debian/muttdelay.substvars | 1 + debian/template.manpages | 1 - debian/template.substvars | 1 - docs/muttdelay.1 | 266 +++++++++++++++++++++++++++++++++++++++++++++ docs/muttdelay.pod | 114 +++++++++++++++++++ docs/muttdelay.txt | 114 +++++++++++++++++++ docs/template.1 | 266 --------------------------------------------- docs/template.pod | 114 ------------------- docs/template.txt | 114 ------------------- src/muttdelay | 5 + src/template | 5 - 19 files changed, 538 insertions(+), 537 deletions(-) create mode 100644 debian/muttdelay.manpages create mode 100644 debian/muttdelay.substvars delete mode 100644 debian/template.manpages delete mode 100644 debian/template.substvars create mode 100644 docs/muttdelay.1 create mode 100644 docs/muttdelay.pod create mode 100644 docs/muttdelay.txt delete mode 100644 docs/template.1 delete mode 100644 docs/template.pod delete mode 100644 docs/template.txt create mode 100755 src/muttdelay delete mode 100755 src/template diff --git a/Makefile b/Makefile index 45d699b..8748fde 100644 --- a/Makefile +++ b/Makefile @@ -1,4 +1,4 @@ -NAME=template +NAME=muttdelay all: version documentation build # THIS IS NEEDED BY THE DEBIAN TOOLS diff --git a/README.pod b/README.pod index 76de14e..65625e3 100644 --- a/README.pod +++ b/README.pod @@ -1,12 +1,12 @@ =head1 NAME -template - A template project +muttdelay - A muttdelay project =head1 WTF? You may use this project in order to build your own Debian package for your own project. This has been tested with Debian GNU/Linux Squeeze and Debian GNU/Linux Wheezy. -Feel free to modify any aspects. This project is just an empty example template. +Feel free to modify any aspects. This project is just an empty example muttdelay. Follow these steps: @@ -26,7 +26,7 @@ Go to the to level directory and run To test run - ./bin/template + ./bin/muttdelay It should print out the version number of the project. @@ -38,27 +38,27 @@ Go to the to level directory and run It will create the files like: - ../template_0.0.0.0_all.deb - ../template_0.0.0.0.dsc - ../template_0.0.0.0_amd64.changes - ../template_0.0.0.0.tar.gz + ../muttdelay_0.0.0.0_all.deb + ../muttdelay_0.0.0.0.dsc + ../muttdelay_0.0.0.0_amd64.changes + ../muttdelay_0.0.0.0.tar.gz It should create a debian package in ../. Check and install it, e.g: - lintian --pedantic ../template_0.0.0.0_all.deb - sudo dpkg -i ../template_0.0.0.0_all.deb + lintian --pedantic ../muttdelay_0.0.0.0_all.deb + sudo dpkg -i ../muttdelay_0.0.0.0_all.deb Run - dpkg -L template + dpkg -L muttdelay to see whats in there. You can now run - /usr/bin/template + /usr/bin/muttdelay or for example - man template + man muttdelay =head2 Read the Makefile @@ -80,26 +80,26 @@ You should also consider the following: =head2 Manual page -This template is using POD for creating manual pages. Edit ./docs/template.pod and run +This muttdelay is using POD for creating manual pages. Edit ./docs/muttdelay.pod and run make documentation -in order to build ./docs/template.1. The page will be included in the resulting debian package automatically. You can review the page with +in order to build ./docs/muttdelay.1. The page will be included in the resulting debian package automatically. You can review the page with - man ./docs/template.1 + man ./docs/muttdelay.1 -=head2 Renaming template into your project name +=head2 Renaming muttdelay into your project name -Rename all files which have *template* included into your own new package name. You can do that with: +Rename all files which have *muttdelay* included into your own new package name. You can do that with: PROJECTNAME=yourproject - find . -name \*template\* | - while read template; do git mv $template ${template/template/$PROJECTNAME}; done + find . -name \*muttdelay\* | + while read muttdelay; do git mv $muttdelay ${muttdelay/muttdelay/$PROJECTNAME}; done -Search all content and rename *template* into your own new package name. You can do that with: +Search all content and rename *muttdelay* into your own new package name. You can do that with: - grep -R template . | grep -v .git | - cut -d: -f1 | uniq | xargs sed -i "s/template/$PROJECTNAME/g" + grep -R muttdelay . | grep -v .git | + cut -d: -f1 | uniq | xargs sed -i "s/muttdelay/$PROJECTNAME/g" =head2 Updating ./debian diff --git a/debian/README b/debian/README index 328f773..01fcd0f 100644 --- a/debian/README +++ b/debian/README @@ -1,4 +1,4 @@ -The Debian Package template +The Debian Package muttdelay ---------------------------- This is just a humble go project. Not sure if everything meets the debian diff --git a/debian/changelog b/debian/changelog index d0e1435..c1d4664 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,5 +1,5 @@ -template (0.0.0) stable; urgency=low +muttdelay (0.0.0) stable; urgency=low - * Initial version of the template + * Initial version of the muttdelay -- Paul Buetow Fri, 04 Jan 2013 07:53:32 +0100 diff --git a/debian/control b/debian/control index 3edcbf2..26d7003 100644 --- a/debian/control +++ b/debian/control @@ -1,15 +1,16 @@ -Source: template +Source: muttdelay Section: utils Priority: optional Maintainer: Paul Buetow Build-Depends: Standards-Version: 3.9.2 -Homepage: https://template.buetow.org -Vcs-Git: https://github.com/rantanplan/template.git -Vcs-Browser: https://github.com/rantanplan/template +Homepage: https://muttdelay.buetow.org +Vcs-Git: https://github.com/rantanplan/muttdelay.git +Vcs-Browser: https://github.com/rantanplan/muttdelay -Package: template +Package: muttdelay Architecture: all Depends: -Description: Small template package - This is just a template package, which cann print Hello World. +Description: Delaying the sending of mails + A bash script to delay mails written via mutt and msmtp. + diff --git a/debian/copyright b/debian/copyright index 7dcaec6..cae12a7 100644 --- a/debian/copyright +++ b/debian/copyright @@ -1,6 +1,6 @@ Format: http://dep.debian.net/deps/dep5 -Upstream-Name: template -Source: http://template.buetow.org +Upstream-Name: muttdelay +Source: http://muttdelay.buetow.org Files: * Copyright: 2012 Paul Buetow diff --git a/debian/files b/debian/files index 4a0eeba..af59806 100644 --- a/debian/files +++ b/debian/files @@ -1 +1 @@ -template_0.0.0_all.deb utils optional +muttdelay_0.0.0_all.deb utils optional diff --git a/debian/muttdelay.manpages b/debian/muttdelay.manpages new file mode 100644 index 0000000..105f17d --- /dev/null +++ b/debian/muttdelay.manpages @@ -0,0 +1 @@ +docs/muttdelay.1 diff --git a/debian/muttdelay.substvars b/debian/muttdelay.substvars new file mode 100644 index 0000000..abd3ebe --- /dev/null +++ b/debian/muttdelay.substvars @@ -0,0 +1 @@ +misc:Depends= diff --git a/debian/template.manpages b/debian/template.manpages deleted file mode 100644 index b4d53bb..0000000 --- a/debian/template.manpages +++ /dev/null @@ -1 +0,0 @@ -docs/template.1 diff --git a/debian/template.substvars b/debian/template.substvars deleted file mode 100644 index abd3ebe..0000000 --- a/debian/template.substvars +++ /dev/null @@ -1 +0,0 @@ -misc:Depends= diff --git a/docs/muttdelay.1 b/docs/muttdelay.1 new file mode 100644 index 0000000..769402e --- /dev/null +++ b/docs/muttdelay.1 @@ -0,0 +1,266 @@ +.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16) +.\" +.\" Standard preamble: +.\" ======================================================================== +.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 (.SS), 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 "TEMPLATE 1" +.TH TEMPLATE 1 "2014-04-10" "muttdelay 0.0.0" "User Commands" +.\" 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" +muttdelay \- A muttdelay project +.SH "WTF?" +.IX Header "WTF?" +You may use this project in order to build your own Debian package for your own project. This has been tested with Debian GNU/Linux Squeeze and Debian GNU/Linux Wheezy. +.PP +Feel free to modify any aspects. This project is just an empty example muttdelay. +.PP +Follow these steps: +.SS "Install required packages" +.IX Subsection "Install required packages" +Run the following: +.PP +.Vb 1 +\& sudo aptitude install lintian devscripts dpkg\-dev make perl +.Ve +.PP +Todo: Ensure this are the correct packages. In order to test that I would have to setup a blank Debian system. +.SS "Compile the project" +.IX Subsection "Compile the project" +Go to the to level directory and run +.PP +.Vb 1 +\& make +.Ve +.PP +To test run +.PP +.Vb 1 +\& ./bin/muttdelay +.Ve +.PP +It should print out the version number of the project. +.SS "Create a Debian package" +.IX Subsection "Create a Debian package" +Go to the to level directory and run +.PP +.Vb 1 +\& make deb +.Ve +.PP +It will create the files like: +.PP +.Vb 4 +\& ../muttdelay_0.0.0.0_all.deb +\& ../muttdelay_0.0.0.0.dsc +\& ../muttdelay_0.0.0.0_amd64.changes +\& ../muttdelay_0.0.0.0.tar.gz +.Ve +.PP +It should create a debian package in ../. Check and install it, e.g: +.PP +.Vb 2 +\& lintian \-\-pedantic ../muttdelay_0.0.0.0_all.deb +\& sudo dpkg \-i ../muttdelay_0.0.0.0_all.deb +.Ve +.PP +Run +.PP +.Vb 1 +\& dpkg \-L muttdelay +.Ve +.PP +to see whats in there. You can now run +.PP +.Vb 1 +\& /usr/bin/muttdelay +.Ve +.PP +or for example +.PP +.Vb 1 +\& man muttdelay +.Ve +.SS "Read the Makefile" +.IX Subsection "Read the Makefile" +Read the Makefile in order to understand what's going on. +.SH "Customize" +.IX Header "Customize" +Now, since you understood everything feel free to customize everything the way you want it. E.g.: +.PP +.Vb 1 +\& Don\*(Aqt use POD for documentation but LaTeX +\& +\& Compile a C program +\& +\& Include a ./lib dir, add it to the \*(Aqinstall\*(Aq Makefile rule +\& +\& etc etc. +.Ve +.PP +You should also consider the following: +.SS "Manual page" +.IX Subsection "Manual page" +This muttdelay is using \s-1POD\s0 for creating manual pages. Edit ./docs/muttdelay.pod and run +.PP +.Vb 1 +\& make documentation +.Ve +.PP +in order to build ./docs/muttdelay.1. The page will be included in the resulting debian package automatically. You can review the page with +.PP +.Vb 1 +\& man ./docs/muttdelay.1 +.Ve +.SS "Renaming muttdelay into your project name" +.IX Subsection "Renaming muttdelay into your project name" +Rename all files which have *muttdelay* included into your own new package name. You can do that with: +.PP +.Vb 3 +\& PROJECTNAME=yourproject +\& find . \-name \e*muttdelay\e* | +\& while read muttdelay; do git mv $muttdelay ${muttdelay/muttdelay/$PROJECTNAME}; done +.Ve +.PP +Search all content and rename *muttdelay* into your own new package name. You can do that with: +.PP +.Vb 2 +\& grep \-R muttdelay . | grep \-v .git | +\& cut \-d: \-f1 | uniq | xargs sed \-i "s/muttdelay/$PROJECTNAME/g" +.Ve +.SS "Updating ./debian" +.IX Subsection "Updating ./debian" +Edit the following files accordingly to your new project (e.g. with vim): +.PP +.Vb 1 +\& vim ./debian/{control,copyright,README} +.Ve +.SS "Update changelog" +.IX Subsection "Update changelog" +Go to the to level directory and run +.PP +.Vb 1 +\& dch \-i +.Ve diff --git a/docs/muttdelay.pod b/docs/muttdelay.pod new file mode 100644 index 0000000..65625e3 --- /dev/null +++ b/docs/muttdelay.pod @@ -0,0 +1,114 @@ +=head1 NAME + +muttdelay - A muttdelay project + +=head1 WTF? + +You may use this project in order to build your own Debian package for your own project. This has been tested with Debian GNU/Linux Squeeze and Debian GNU/Linux Wheezy. + +Feel free to modify any aspects. This project is just an empty example muttdelay. + +Follow these steps: + +=head2 Install required packages + +Run the following: + + sudo aptitude install lintian devscripts dpkg-dev make perl + +Todo: Ensure this are the correct packages. In order to test that I would have to setup a blank Debian system. + +=head2 Compile the project + +Go to the to level directory and run + + make + +To test run + + ./bin/muttdelay + +It should print out the version number of the project. + +=head2 Create a Debian package + +Go to the to level directory and run + + make deb + +It will create the files like: + + ../muttdelay_0.0.0.0_all.deb + ../muttdelay_0.0.0.0.dsc + ../muttdelay_0.0.0.0_amd64.changes + ../muttdelay_0.0.0.0.tar.gz + +It should create a debian package in ../. Check and install it, e.g: + + lintian --pedantic ../muttdelay_0.0.0.0_all.deb + sudo dpkg -i ../muttdelay_0.0.0.0_all.deb + +Run + + dpkg -L muttdelay + +to see whats in there. You can now run + + /usr/bin/muttdelay + +or for example + + man muttdelay + +=head2 Read the Makefile + +Read the Makefile in order to understand what's going on. + +=head1 Customize + +Now, since you understood everything feel free to customize everything the way you want it. E.g.: + + Don't use POD for documentation but LaTeX + + Compile a C program + + Include a ./lib dir, add it to the 'install' Makefile rule + + etc etc. + +You should also consider the following: + +=head2 Manual page + +This muttdelay is using POD for creating manual pages. Edit ./docs/muttdelay.pod and run + + make documentation + +in order to build ./docs/muttdelay.1. The page will be included in the resulting debian package automatically. You can review the page with + + man ./docs/muttdelay.1 + +=head2 Renaming muttdelay into your project name + +Rename all files which have *muttdelay* included into your own new package name. You can do that with: + + PROJECTNAME=yourproject + find . -name \*muttdelay\* | + while read muttdelay; do git mv $muttdelay ${muttdelay/muttdelay/$PROJECTNAME}; done + +Search all content and rename *muttdelay* into your own new package name. You can do that with: + + grep -R muttdelay . | grep -v .git | + cut -d: -f1 | uniq | xargs sed -i "s/muttdelay/$PROJECTNAME/g" + +=head2 Updating ./debian + +Edit the following files accordingly to your new project (e.g. with vim): + + vim ./debian/{control,copyright,README} + +=head2 Update changelog + +Go to the to level directory and run + + dch -i diff --git a/docs/muttdelay.txt b/docs/muttdelay.txt new file mode 100644 index 0000000..2ce9cb3 --- /dev/null +++ b/docs/muttdelay.txt @@ -0,0 +1,114 @@ +NAME + muttdelay - A muttdelay project + +WTF? + You may use this project in order to build your own Debian package for + your own project. This has been tested with Debian GNU/Linux Squeeze and + Debian GNU/Linux Wheezy. + + Feel free to modify any aspects. This project is just an empty example + muttdelay. + + Follow these steps: + + Install required packages + Run the following: + + sudo aptitude install lintian devscripts dpkg-dev make perl + + Todo: Ensure this are the correct packages. In order to test that I + would have to setup a blank Debian system. + + Compile the project + Go to the to level directory and run + + make + + To test run + + ./bin/muttdelay + + It should print out the version number of the project. + + Create a Debian package + Go to the to level directory and run + + make deb + + It will create the files like: + + ../muttdelay_0.0.0.0_all.deb + ../muttdelay_0.0.0.0.dsc + ../muttdelay_0.0.0.0_amd64.changes + ../muttdelay_0.0.0.0.tar.gz + + It should create a debian package in ../. Check and install it, e.g: + + lintian --pedantic ../muttdelay_0.0.0.0_all.deb + sudo dpkg -i ../muttdelay_0.0.0.0_all.deb + + Run + + dpkg -L muttdelay + + to see whats in there. You can now run + + /usr/bin/muttdelay + + or for example + + man muttdelay + + Read the Makefile + Read the Makefile in order to understand what's going on. + +Customize + Now, since you understood everything feel free to customize everything + the way you want it. E.g.: + + Don't use POD for documentation but LaTeX + + Compile a C program + + Include a ./lib dir, add it to the 'install' Makefile rule + + etc etc. + + You should also consider the following: + + Manual page + This muttdelay is using POD for creating manual pages. Edit + ./docs/muttdelay.pod and run + + make documentation + + in order to build ./docs/muttdelay.1. The page will be included in the + resulting debian package automatically. You can review the page with + + man ./docs/muttdelay.1 + + Renaming muttdelay into your project name + Rename all files which have *muttdelay* included into your own new + package name. You can do that with: + + PROJECTNAME=yourproject + find . -name \*muttdelay\* | + while read muttdelay; do git mv $muttdelay ${muttdelay/muttdelay/$PROJECTNAME}; done + + Search all content and rename *muttdelay* into your own new package name. + You can do that with: + + grep -R muttdelay . | grep -v .git | + cut -d: -f1 | uniq | xargs sed -i "s/muttdelay/$PROJECTNAME/g" + + Updating ./debian + Edit the following files accordingly to your new project (e.g. with + vim): + + vim ./debian/{control,copyright,README} + + Update changelog + Go to the to level directory and run + + dch -i + diff --git a/docs/template.1 b/docs/template.1 deleted file mode 100644 index a2947fa..0000000 --- a/docs/template.1 +++ /dev/null @@ -1,266 +0,0 @@ -.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16) -.\" -.\" Standard preamble: -.\" ======================================================================== -.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 (.SS), 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 "TEMPLATE 1" -.TH TEMPLATE 1 "2014-04-10" "template 0.0.0" "User Commands" -.\" 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" -template \- A template project -.SH "WTF?" -.IX Header "WTF?" -You may use this project in order to build your own Debian package for your own project. This has been tested with Debian GNU/Linux Squeeze and Debian GNU/Linux Wheezy. -.PP -Feel free to modify any aspects. This project is just an empty example template. -.PP -Follow these steps: -.SS "Install required packages" -.IX Subsection "Install required packages" -Run the following: -.PP -.Vb 1 -\& sudo aptitude install lintian devscripts dpkg\-dev make perl -.Ve -.PP -Todo: Ensure this are the correct packages. In order to test that I would have to setup a blank Debian system. -.SS "Compile the project" -.IX Subsection "Compile the project" -Go to the to level directory and run -.PP -.Vb 1 -\& make -.Ve -.PP -To test run -.PP -.Vb 1 -\& ./bin/template -.Ve -.PP -It should print out the version number of the project. -.SS "Create a Debian package" -.IX Subsection "Create a Debian package" -Go to the to level directory and run -.PP -.Vb 1 -\& make deb -.Ve -.PP -It will create the files like: -.PP -.Vb 4 -\& ../template_0.0.0.0_all.deb -\& ../template_0.0.0.0.dsc -\& ../template_0.0.0.0_amd64.changes -\& ../template_0.0.0.0.tar.gz -.Ve -.PP -It should create a debian package in ../. Check and install it, e.g: -.PP -.Vb 2 -\& lintian \-\-pedantic ../template_0.0.0.0_all.deb -\& sudo dpkg \-i ../template_0.0.0.0_all.deb -.Ve -.PP -Run -.PP -.Vb 1 -\& dpkg \-L template -.Ve -.PP -to see whats in there. You can now run -.PP -.Vb 1 -\& /usr/bin/template -.Ve -.PP -or for example -.PP -.Vb 1 -\& man template -.Ve -.SS "Read the Makefile" -.IX Subsection "Read the Makefile" -Read the Makefile in order to understand what's going on. -.SH "Customize" -.IX Header "Customize" -Now, since you understood everything feel free to customize everything the way you want it. E.g.: -.PP -.Vb 1 -\& Don\*(Aqt use POD for documentation but LaTeX -\& -\& Compile a C program -\& -\& Include a ./lib dir, add it to the \*(Aqinstall\*(Aq Makefile rule -\& -\& etc etc. -.Ve -.PP -You should also consider the following: -.SS "Manual page" -.IX Subsection "Manual page" -This template is using \s-1POD\s0 for creating manual pages. Edit ./docs/template.pod and run -.PP -.Vb 1 -\& make documentation -.Ve -.PP -in order to build ./docs/template.1. The page will be included in the resulting debian package automatically. You can review the page with -.PP -.Vb 1 -\& man ./docs/template.1 -.Ve -.SS "Renaming template into your project name" -.IX Subsection "Renaming template into your project name" -Rename all files which have *template* included into your own new package name. You can do that with: -.PP -.Vb 3 -\& PROJECTNAME=yourproject -\& find . \-name \e*template\e* | -\& while read template; do git mv $template ${template/template/$PROJECTNAME}; done -.Ve -.PP -Search all content and rename *template* into your own new package name. You can do that with: -.PP -.Vb 2 -\& grep \-R template . | grep \-v .git | -\& cut \-d: \-f1 | uniq | xargs sed \-i "s/template/$PROJECTNAME/g" -.Ve -.SS "Updating ./debian" -.IX Subsection "Updating ./debian" -Edit the following files accordingly to your new project (e.g. with vim): -.PP -.Vb 1 -\& vim ./debian/{control,copyright,README} -.Ve -.SS "Update changelog" -.IX Subsection "Update changelog" -Go to the to level directory and run -.PP -.Vb 1 -\& dch \-i -.Ve diff --git a/docs/template.pod b/docs/template.pod deleted file mode 100644 index 76de14e..0000000 --- a/docs/template.pod +++ /dev/null @@ -1,114 +0,0 @@ -=head1 NAME - -template - A template project - -=head1 WTF? - -You may use this project in order to build your own Debian package for your own project. This has been tested with Debian GNU/Linux Squeeze and Debian GNU/Linux Wheezy. - -Feel free to modify any aspects. This project is just an empty example template. - -Follow these steps: - -=head2 Install required packages - -Run the following: - - sudo aptitude install lintian devscripts dpkg-dev make perl - -Todo: Ensure this are the correct packages. In order to test that I would have to setup a blank Debian system. - -=head2 Compile the project - -Go to the to level directory and run - - make - -To test run - - ./bin/template - -It should print out the version number of the project. - -=head2 Create a Debian package - -Go to the to level directory and run - - make deb - -It will create the files like: - - ../template_0.0.0.0_all.deb - ../template_0.0.0.0.dsc - ../template_0.0.0.0_amd64.changes - ../template_0.0.0.0.tar.gz - -It should create a debian package in ../. Check and install it, e.g: - - lintian --pedantic ../template_0.0.0.0_all.deb - sudo dpkg -i ../template_0.0.0.0_all.deb - -Run - - dpkg -L template - -to see whats in there. You can now run - - /usr/bin/template - -or for example - - man template - -=head2 Read the Makefile - -Read the Makefile in order to understand what's going on. - -=head1 Customize - -Now, since you understood everything feel free to customize everything the way you want it. E.g.: - - Don't use POD for documentation but LaTeX - - Compile a C program - - Include a ./lib dir, add it to the 'install' Makefile rule - - etc etc. - -You should also consider the following: - -=head2 Manual page - -This template is using POD for creating manual pages. Edit ./docs/template.pod and run - - make documentation - -in order to build ./docs/template.1. The page will be included in the resulting debian package automatically. You can review the page with - - man ./docs/template.1 - -=head2 Renaming template into your project name - -Rename all files which have *template* included into your own new package name. You can do that with: - - PROJECTNAME=yourproject - find . -name \*template\* | - while read template; do git mv $template ${template/template/$PROJECTNAME}; done - -Search all content and rename *template* into your own new package name. You can do that with: - - grep -R template . | grep -v .git | - cut -d: -f1 | uniq | xargs sed -i "s/template/$PROJECTNAME/g" - -=head2 Updating ./debian - -Edit the following files accordingly to your new project (e.g. with vim): - - vim ./debian/{control,copyright,README} - -=head2 Update changelog - -Go to the to level directory and run - - dch -i diff --git a/docs/template.txt b/docs/template.txt deleted file mode 100644 index 5200d1f..0000000 --- a/docs/template.txt +++ /dev/null @@ -1,114 +0,0 @@ -NAME - template - A template project - -WTF? - You may use this project in order to build your own Debian package for - your own project. This has been tested with Debian GNU/Linux Squeeze and - Debian GNU/Linux Wheezy. - - Feel free to modify any aspects. This project is just an empty example - template. - - Follow these steps: - - Install required packages - Run the following: - - sudo aptitude install lintian devscripts dpkg-dev make perl - - Todo: Ensure this are the correct packages. In order to test that I - would have to setup a blank Debian system. - - Compile the project - Go to the to level directory and run - - make - - To test run - - ./bin/template - - It should print out the version number of the project. - - Create a Debian package - Go to the to level directory and run - - make deb - - It will create the files like: - - ../template_0.0.0.0_all.deb - ../template_0.0.0.0.dsc - ../template_0.0.0.0_amd64.changes - ../template_0.0.0.0.tar.gz - - It should create a debian package in ../. Check and install it, e.g: - - lintian --pedantic ../template_0.0.0.0_all.deb - sudo dpkg -i ../template_0.0.0.0_all.deb - - Run - - dpkg -L template - - to see whats in there. You can now run - - /usr/bin/template - - or for example - - man template - - Read the Makefile - Read the Makefile in order to understand what's going on. - -Customize - Now, since you understood everything feel free to customize everything - the way you want it. E.g.: - - Don't use POD for documentation but LaTeX - - Compile a C program - - Include a ./lib dir, add it to the 'install' Makefile rule - - etc etc. - - You should also consider the following: - - Manual page - This template is using POD for creating manual pages. Edit - ./docs/template.pod and run - - make documentation - - in order to build ./docs/template.1. The page will be included in the - resulting debian package automatically. You can review the page with - - man ./docs/template.1 - - Renaming template into your project name - Rename all files which have *template* included into your own new - package name. You can do that with: - - PROJECTNAME=yourproject - find . -name \*template\* | - while read template; do git mv $template ${template/template/$PROJECTNAME}; done - - Search all content and rename *template* into your own new package name. - You can do that with: - - grep -R template . | grep -v .git | - cut -d: -f1 | uniq | xargs sed -i "s/template/$PROJECTNAME/g" - - Updating ./debian - Edit the following files accordingly to your new project (e.g. with - vim): - - vim ./debian/{control,copyright,README} - - Update changelog - Go to the to level directory and run - - dch -i - diff --git a/src/muttdelay b/src/muttdelay new file mode 100755 index 0000000..a5a8bf5 --- /dev/null +++ b/src/muttdelay @@ -0,0 +1,5 @@ +#!/usr/bin/env bash + +declare -r VERSION='VERSION_DEVEL' + +echo "This is version $VERSION of the example muttdelay project." diff --git a/src/template b/src/template deleted file mode 100755 index 38ff9b8..0000000 --- a/src/template +++ /dev/null @@ -1,5 +0,0 @@ -#!/usr/bin/env bash - -declare -r VERSION='VERSION_DEVEL' - -echo "This is version $VERSION of the example template project." -- cgit v1.2.3