diff options
| author | Paul C. Buetow (mars.fritz.box) <paul@buetow.org> | 2014-06-20 01:14:29 +0200 |
|---|---|---|
| committer | Paul C. Buetow (mars.fritz.box) <paul@buetow.org> | 2014-06-20 01:14:29 +0200 |
| commit | 2e06d2975e14cc14f6902f0e125de09b19135de9 (patch) | |
| tree | 8a0bfdb98ae136cf5f3cd2508112cb83f23bd2bc | |
| parent | 8634cef386a7d786f038424c95f0a9b59028ac35 (diff) | |
add minimal manpage
| -rw-r--r-- | README.txt | 4 | ||||
| -rw-r--r-- | docs/netdiff.1 | 4 | ||||
| -rw-r--r-- | docs/netdiff.pod | 109 | ||||
| -rw-r--r-- | docs/netdiff.txt | 4 |
4 files changed, 16 insertions, 105 deletions
@@ -88,8 +88,8 @@ Customize man ./docs/netdiff.1 Renaming netdiff into your project name - Rename all files which have *netdiff* included into your own new - package name. You can do that with: + Rename all files which have *netdiff* included into your own new package + name. You can do that with: PROJECTNAME=yourproject find . -name \*netdiff\* | diff --git a/docs/netdiff.1 b/docs/netdiff.1 index c7e16a8..849457c 100644 --- a/docs/netdiff.1 +++ b/docs/netdiff.1 @@ -123,8 +123,8 @@ .rm #[ #] #H #V #F C .\" ======================================================================== .\" -.IX Title "TEMPLATE 1" -.TH TEMPLATE 1 "2014-04-10" "netdiff 0.0.0" "User Commands" +.IX Title "NETDIFF 1" +.TH NETDIFF 1 "2014-06-20" "netdiff 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 diff --git a/docs/netdiff.pod b/docs/netdiff.pod index 51d3e63..fa9fbb7 100644 --- a/docs/netdiff.pod +++ b/docs/netdiff.pod @@ -4,111 +4,22 @@ netdiff - A netdiff 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. +A simple script to diff two files via the network. -Feel free to modify any aspects. This project is just an empty example netdiff. +=head2 usage -Follow these steps: +ClusterSSH onto two hosts at the same time and run on both hosts the same command like: -=head2 Install required packages + netdiff HOSTNAME FILENAME -Run the following: +Where HOSTNAME can be the hostname of the first or the second host. Depending on this the script will decide to be the client or the server role. - sudo aptitude install lintian devscripts dpkg-dev make perl +=head1 LICENSE -Todo: Ensure this are the correct packages. In order to test that I would have to setup a blank Debian system. +See package description or project website. -=head2 Compile the project +=head1 AUTHOR -Go to the to level directory and run +Paul Buetow - <http://netdiff.buetow.org> - make - -To test run - - ./bin/netdiff - -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: - - ../netdiff_0.0.0.0_all.deb - ../netdiff_0.0.0.0.dsc - ../netdiff_0.0.0.0_amd64.changes - ../netdiff_0.0.0.0.tar.gz - -It should create a debian package in ../. Check and install it, e.g: - - lintian --pedantic ../netdiff_0.0.0.0_all.deb - sudo dpkg -i ../netdiff_0.0.0.0_all.deb - -Run - - dpkg -L netdiff - -to see whats in there. You can now run - - /usr/bin/netdiff - -or for example - - man netdiff - -=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 netdiff is using POD for creating manual pages. Edit ./docs/netdiff.pod and run - - make documentation - -in order to build ./docs/netdiff.1. The page will be included in the resulting debian package automatically. You can review the page with - - man ./docs/netdiff.1 - -=head2 Renaming netdiff into your project name - -Rename all files which have *netdiff* included into your own new package name. You can do that with: - - PROJECTNAME=yourproject - find . -name \*netdiff\* | - while read netdiff; do git mv $netdiff ${netdiff/netdiff/$PROJECTNAME}; done - -Search all content and rename *netdiff* into your own new package name. You can do that with: - - grep -R netdiff . | grep -v .git | - cut -d: -f1 | uniq | xargs sed -i "s/netdiff/$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 +=cut diff --git a/docs/netdiff.txt b/docs/netdiff.txt index 815c823..98f6a27 100644 --- a/docs/netdiff.txt +++ b/docs/netdiff.txt @@ -88,8 +88,8 @@ Customize man ./docs/netdiff.1 Renaming netdiff into your project name - Rename all files which have *netdiff* included into your own new - package name. You can do that with: + Rename all files which have *netdiff* included into your own new package + name. You can do that with: PROJECTNAME=yourproject find . -name \*netdiff\* | |
