[Cdd-commits] r798 - cdd/trunk/cdd/doc/en

[CDD Subversion Commit]

Author: tille
Date: Thu Jun  5 06:37:05 2008
New Revision: 798

Modified:
   cdd/trunk/cdd/doc/en/04_existing_cdds.sgml
   cdd/trunk/cdd/doc/en/A_devel.sgml
   cdd/trunk/cdd/doc/en/B_quickintro.sgml
Log:
SOme enhancements for the docs.


Modified: cdd/trunk/cdd/doc/en/04_existing_cdds.sgml
==============================================================================
--- cdd/trunk/cdd/doc/en/04_existing_cdds.sgml	(original)
+++ cdd/trunk/cdd/doc/en/04_existing_cdds.sgml	Thu Jun  5 06:37:05 2008
@@ -375,26 +375,20 @@
 <taglist>
   <tag>Start</tag>
    <item>February 2003</item>
-  <tag>Initiator</tag>
-   <item>Mario Lang <email>mlang at debian.org</email></item>
-  <tag>URL</tag>
-   <item><url name="Debian-Accessibility" id="http://www.debian.org/devel/debian-accessibility/"></item>
   <tag>Mailing list</tag>
    <item><url name=" debian-accessibility at lists.debian.org" id="http://lists.debian.org/debian-accessibility/"></item>
+  <tag>URL</tag>
+   <item><url name="Debian-Accessibility" id="http://www.debian.org/devel/debian-accessibility/"></item>
+  <tag>Initiator</tag>
+   <item>Mario Lang <email>mlang at debian.org</email></item>
   <tag>Goals</tag>
    <item>
     <list>
      <item>To make Debian accessible to people with disabilities.</item>
-     <item>To take special care for:
-      <list>
-          <item>Screen readers</item>
-	  <item>Screen magnification programs</item>
-	  <item>Software speech synthesisers</item>
-          <item>Speech recognition software</item>
-	  <item>Scanner drivers and OCR software</item>
-	  <item>Specialised software like edbrowse (web-browse in the
-                spirit of line-editors)</item>
-      </list>
+     <item>To take special care for: Screen readers; Screen magnification programs;
+	   Software speech synthesisers; Speech recognition software; Scanner drivers
+	   and OCR software; Specialised software like edbrowse (web-browse in the
+           spirit of line-editors)
      </item> 
      <item>To make text-mode interfaces available.</item>
      <item>To provide screen reader functionality during installation.</item>

Modified: cdd/trunk/cdd/doc/en/A_devel.sgml
==============================================================================
--- cdd/trunk/cdd/doc/en/A_devel.sgml	(original)
+++ cdd/trunk/cdd/doc/en/A_devel.sgml	Thu Jun  5 06:37:05 2008
@@ -453,12 +453,20 @@
    <item>
     Change into the created directory and type
 <example>
-  make -f debian/rules dist
+  make -f debian/rules get-orig-source
 </example>
     This creates a <file>tar.gz</file> source archive of the packages
-    you want to build. (Note: This requires that
-    <file>debian/rules</file> has a <tt>dist</tt> target which is the
-    case for all currently existing files.)
+    you want to build.  For your personal comfort you can create a
+    file <file>Makefile</file> in your package source directory containing
+<example>
+  #!/usr/bin/make -f 
+  include /usr/share/cdd-dev/Makefile
+</example>
+    Which enables you to simply say
+<example>
+    make dist
+</example>
+    to create the source tarball.
    </item>
   <tag>Build Debian packages</tag>
    <item>

Modified: cdd/trunk/cdd/doc/en/B_quickintro.sgml
==============================================================================
--- cdd/trunk/cdd/doc/en/B_quickintro.sgml	(original)
+++ cdd/trunk/cdd/doc/en/B_quickintro.sgml	Thu Jun  5 06:37:05 2008
@@ -78,8 +78,19 @@
 <example>
 ~> make -f debian/rules get-orig-source
 </example>
-This tarball has to be moved to a location where the meta packages
-will be built.  Unpack the tarball there and start the build process
+For your comfort you might like to create a file
+<file>Makefile</file> containing
+<example>
+#!/usr/bin/make -f 
+include /usr/share/cdd-dev/Makefile
+</example>
+which enables you to simply use
+<example>
+~> make dist
+</example>
+to build the source tarball. This tarball has to be moved to a location
+where the meta packages will be built. 
+Unpack the tarball there and start the build process
 using for instance
 <example>
 ~> debuild