summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPaul C. Buetow (mars.fritz.box) <paul@buetow.org>2014-06-22 11:13:23 +0200
committerPaul C. Buetow (mars.fritz.box) <paul@buetow.org>2014-06-22 11:13:23 +0200
commit6b3174a2c6760a0b42790bc12fd76f6e8ff10077 (patch)
tree84b7254920436e2052630c0d5ebf333d7cf164db
parenta89b16ba11ac13eb4b974f1fce6e3ad8366d0201 (diff)
use README.pod instead of README.txt because github can interpred PODs
-rw-r--r--Makefile4
-rw-r--r--README.txt114
2 files changed, 3 insertions, 115 deletions
diff --git a/Makefile b/Makefile
index 6d1e038..474dc9d 100644
--- a/Makefile
+++ b/Makefile
@@ -33,7 +33,9 @@ version:
documentation:
pod2man --release="$(NAME) $$(cat .version)" \
--center="User Commands" ./docs/$(NAME).pod > ./docs/$(NAME).1
- pod2text ./docs/$(NAME).pod | tee ./docs/$(NAME).txt > README.txt
+ #pod2text ./docs/$(NAME).pod | tee ./docs/$(NAME).txt > README.txt
+ pod2text ./docs/$(NAME).pod > ./docs/$(NAME).txt
+ cp ./docs/$(NAME).pod ./README.pod
# Build a debian package (don't sign it, modify the arguments if you want to sign it)
deb: all
diff --git a/README.txt b/README.txt
deleted file mode 100644
index 5200d1f..0000000
--- a/README.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
-