some more improvements plus creation of trunk branches and tags

README

@@ -2,13 +2,14 @@ bootstrap-build-environment
 
 Simply setup a new project:
  1. create a subversion basic tree
- 2. checkout trunk of the new subversion repository
+ 2. checkoutsubversion repository
  3. cd into the new project subversion working copy
  4. call with full path: /path/to/bootstrap.sh
- 5. follow the instructions, i.e. edit configure.ac
- 6. run again: /path/to/bootstrap.sh
- 7. add some generated files: svn add COPYING ChangeLog INSTALL
- 8. your project is setup and compilable, test: ./bootstrap.sh -b
+ 5. if trunk has been created, cd to trunk
+ 6. follow the instructions, i.e. edit configure.ac
+ 7. run again: /path/to/bootstrap.sh
+ 8. add some generated files: svn add COPYING ChangeLog INSTALL
+ 9. your project is setup and compilable, test: ./bootstrap.sh -b
 
 Fore more details, see:
   ./bootstrap.sh -h
@@ -27,3 +28,47 @@ Supports and preconfigures:
  - Debian packaging
  - RPM packaging
  - Mac OSX App Bundle creation
+
+Example:
+
+There is a just created empty subversion repository:
+  https://dev.marc.waeckerlin.org/svn/project-name
+
+Setup a basic project:
+
+    svn co https://dev.marc.waeckerlin.org/svn/project-name
+    cd project-name
+    ../bootstrap-build-environment/scripts/bootstrap.sh
+    cd trunk
+
+The file AUTHORS is already correct due to my gnupg setup:
+
+    Fistname Lastname (https://my.homepage.xyz) <me@mysite.xyz>
+
+Edit the file README, I add the following lines:
+
+    First line is the headline, the short description, e.g. in the packages
+    
+    The following lines describe your project...
+    They also appear in the package description
+
+Edit configure.ac, since I want to publish scripts, generate doxygen, debian and rpm packages, I enable the following lines:
+
+    AX_USE_SCRIPTS
+    AX_USE_DOXYGEN
+    AX_USE_DEBIAN_PACKAGING
+    AX_USE_RPM_PACKAGING
+
+Also I check "Section" in debian/control.in and set it do development.
+
+Then I continue, I rerun bootstrap.sh, this time with option -b which calls make distcheck at the end:
+
+    ../../bootstrap-build-environment/scripts/bootstrap.sh -b
+
+Everything is fine, so checkin the changes and cleanup the system:
+
+    cd ..
+    svn ci -m "initial project creation"
+    cd ..
+    rm -rf project-name
+    svn co https://dev.marc.waeckerlin.org/svn/project-name/trunk project-name