[Webapps-common-discuss] webapps-common/doc Makefile,1.1,1.2 Webapps-Policy-Manual-DRAFT.sgml,1.8,1.9
seanius@haydn.debian.org
seanius@haydn.debian.org
Update of /cvsroot/webapps-common/webapps-common/doc
In directory haydn:/org/alioth.debian.org/chroot/home/users/seanius/tmp/cvs-serv3579
Modified Files:
Makefile Webapps-Policy-Manual-DRAFT.sgml
Log Message:
reworked "scope" section, that is not as redundant to the abstract
Index: Makefile
===================================================================
RCS file: /cvsroot/webapps-common/webapps-common/doc/Makefile,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- Makefile 15 May 2005 16:13:46 -0000 1.1
+++ Makefile 4 Jul 2005 18:35:25 -0000 1.2
@@ -1,5 +1,6 @@
# example Makefile for viewing/editing an encrypted file
FILEBASE = Webapps-Policy-Manual-DRAFT
+SRC := $(FILEBASE).sgml
FILECRYPT = $(FILEPLAIN).gpg
RM = /bin/rm -i
@@ -16,41 +17,42 @@
make tov;
make latex;
clean:
- @$(RM) -f $(FILEBASE).txt
- @$(RM) -f $(FILEBASE).dvi
- @$(RM) -rf $(FILEBASE)
- @$(RM) -f $(FILEBASE).info
- @$(RM) -f $(FILEBASE).tex
- @$(RM) -f $(FILEBASE).pdf
- @$(RM) -f $(FILEBASE).ps
- @$(RM) -f $(FILEBASE).tov
- @$(RM) -f $(FILEBASE).tpt
- @$(RM) -f $(FILEBASE).xml
+ $(RM) -f $(FILEBASE).txt
+ $(RM) -f $(FILEBASE).dvi
+ $(RM) -rf $(FILEBASE)
+ $(RM) -f $(FILEBASE).info
+ $(RM) -f $(FILEBASE).tex
+ $(RM) -f $(FILEBASE).pdf
+ $(RM) -f $(FILEBASE).ps
+ $(RM) -f $(FILEBASE).tov
+ $(RM) -f $(FILEBASE).tpt
+ $(RM) -f $(FILEBASE).xml
-xml:
- @debiandoc2docbookxml $(FILEBASE).sgml
+xml: $(SRC)
+ debiandoc2docbookxml $(FILEBASE).sgml
-dvi:
- @debiandoc2dvi $(FILEBASE).sgml
+dvi: $(SRC)
+ debiandoc2dvi $(FILEBASE).sgml
-html:
- @debiandoc2html $(FILEBASE).sgml
- @mv $(FILEBASE).html $(FILEBASE)
+html: $(SRC)
+ rm -rf $(FILEBASE)
+ debiandoc2html $(FILEBASE).sgml
+ mv $(FILEBASE).html $(FILEBASE)
-info:
- @debiandoc2info $(FILEBASE).sgml
+info: $(SRC)
+ debiandoc2info $(FILEBASE).sgml
-latex:
- @debiandoc2latex $(FILEBASE).sgml
+latex: $(SRC)
+ debiandoc2latex $(FILEBASE).sgml
-ps:
- @debiandoc2ps $(FILEBASE).sgml
+ps: $(SRC)
+ debiandoc2ps $(FILEBASE).sgml
-pdf:
- @debiandoc2pdf $(FILEBASE).sgml
+pdf: $(SRC)
+ debiandoc2pdf $(FILEBASE).sgml
-text:
- @debiandoc2text $(FILEBASE).sgml
+text: $(SRC)
+ debiandoc2text $(FILEBASE).sgml
-tov:
- @debiandoc2textov $(FILEBASE).sgml
+tov: $(SRC)
+ debiandoc2textov $(FILEBASE).sgml
Index: Webapps-Policy-Manual-DRAFT.sgml
===================================================================
RCS file: /cvsroot/webapps-common/webapps-common/doc/Webapps-Policy-Manual-DRAFT.sgml,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -d -r1.8 -r1.9
--- Webapps-Policy-Manual-DRAFT.sgml 29 Jun 2005 13:06:15 -0000 1.8
+++ Webapps-Policy-Manual-DRAFT.sgml 4 Jul 2005 18:35:25 -0000 1.9
@@ -35,23 +35,23 @@
<chapt id="about">About this manual
<sect id="about-scope">Scope
<p>
- This manual describes the policy requirements for the packaging of web
- application in the Debian GNU/Linux distribution.
- This includes a description of the scope covered by this policy section,
- several design issues of web applications, as well as technical requirements
- that each web application package must satisfy to be included in the
- distribution.
- <p>
- More and more web applications are packaged in Debian but the current <url id="http://www.debian.org/doc/debian-policy/" name="Debian
- Policy Manual"> does not give guidelines to help web applications maintainers.
- <p>
- This Policy Manual aims to fill this blank.
+ This manual aims to clarify the
+ standards and technical requirements
+ for web-based software in the Debian
+ GNU/Linux distribution.
<p>
- Each package that provides an application available through a web interface is
- supposed to be compliant with this policy manual.
+ Web-based software encompasses the group
+ of software packages which are designed to
+ be accessed via the Hyper Text Transfer
+ Protocol (HTTP) and similar client/server based
+ content distribution protocols. This
+ includes web servers, and applications
+ which are designed to run on top of
+ such servers.
<sect id="about-authors">Authors and Maintainers
<p>
- This policy manual has been written by the members of the Debian Webapps Team:
+ This policy manual has been written by
+ the members of the Debian Webapps Team:
<p>
<list>
<item>Alexis Sukrieh
@@ -59,8 +59,6 @@
<item>Neil McGovern
<item>Sean Finney
</list>
- <p>
- <em>FIXME: add here your name ;)</em>
<p>
While the authors of this document have tried hard to avoid typos and other
errors, these do still occur. If you discover an error in this manual or if you