From fedora-docs-commits at redhat.com Wed Jun 10 15:29:10 2015
Content-Type: multipart/mixed; boundary="===============2327365198172800251=="
MIME-Version: 1.0
From: fedora-docs-commits at redhat.com
To: docs-commits at lists.fedoraproject.org
Subject: example-tutorial example-tutorial-de.xml, NONE, 1.1 Makefile, 1.18,
 1.19 rpm-info.xml, 1.2, 1.3 example-tutorial-it.xml, 1.1, NONE
Date: Sun, 27 Nov 2005 12:57:30 -0500
Message-ID: <200511271757.jARHvU7f022601@cvs-int.fedora.redhat.com>

--===============2327365198172800251==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

Author: pfrields

Update of /cvs/docs/example-tutorial
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv22579

Modified Files:
	Makefile rpm-info.xml =

Added Files:
	example-tutorial-de.xml =

Removed Files:
	example-tutorial-it.xml =

Log Message:
Ignore some of the makefile cruft at the bottom... in transition, obviously.
Also, moved "it" i18n stuff to "de" to match what's in Makefile and rpm-inf=
o.xml file.



--- NEW FILE example-tutorial-de.xml ---
<!-- $Id: -->
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [

 <!ENTITY % FEDORA-ENTITIES-EN SYSTEM "../docs-common/common/fedora-entitie=
s-en.ent">
%FEDORA-ENTITIES-EN;

<!ENTITY BOOKNAME "example-tutorial">
<!ENTITY BOOKVERSION "0.14"> <!-- change version here -->
<!ENTITY BOOKDATE "2005-09-18"> <!-- change revision date here -->
<!ENTITY BOOKID "&BOOKNAME;-&BOOKVERSION; (&BOOKDATE;)">
<!ENTITY BUG-NUM "000000"> <!-- use this only while in draft stage -->

]>

<!-- This file is just a copy of the English version, only here for testing=
 -->
<!-- Makefile locale capabilities.  Nobody really needs to translate this -=
->
<!-- yet. -->


<article id=3D"example-tutorial" lang=3D"it">
  <articleinfo>
    <title>Example Tutorial</title>
    <copyright>
      <year>2003, 2005</year>
      <holder>&FORMAL-RHI;</holder>
      <holder>Tammy Fox</holder>
    </copyright>
    <authorgroup>
      <author>
  <surname>Fox</surname>
  <firstname>Tammy</firstname>
      </author>
      <editor>
  <surname>Frields</surname>
  <firstname>Paul</firstname>
  <othername role=3D"mi">W.</othername>
      </editor>
    </authorgroup>
    &LEGALNOTICE;
    <revhistory>
      <revision>
	<revnumber>0.13</revnumber>
	<date>2005-09-18</date>
	<authorinitials>PaulWFrields</authorinitials>
	<revdescription>
	  <para>
	    Add revision history.
	  </para>
	</revdescription>
      </revision>
    </revhistory>
  </articleinfo>

  <section id=3D"sn-some-section">
    <title>Some Section</title>

    <indexterm>
      <primary>Index term</primary>
    </indexterm>

    <para>
      This is an example section. You should not use sect1, sect2, etc., si=
nce
      those tags will make sections less modular &mdash; that is, harder to
      relocate without changing a lot of other markup.
    </para>
    <para>
      Keep text within the <command>title</command> tags on the same line a=
s the
      tags. Nesting the title on a separate line from the enclosing tags re=
sults
      in extra spaces in HTML rendering.
    </para>

    <warning>
      <title>Warning</title>
      <para>
        Example of an admonition.
      </para>
    </warning>

    <para>
      This paragraph illustrates the use of command syntax to accomplish a
      task. Note that specific filenames denoting versions should be
      avoided. To install any RPM package, use the following syntax:
    </para>
<screen>
<userinput><command>rpm -ivh <replaceable>pkgname</replaceable>-<replaceabl=
e>version</replaceable>.<replaceable>arch</replaceable>.rpm</command></user=
input>
</screen>
    <para>
      Notice that the <command>screen</command> section is entirely
      left-justified with no preceding indent. This is necessary to ensure
      proper rendering in PDFs. Also notice that the entire
      <command>command</command> has been surrounded by
      <command>userinput</command> since the user types this
      command. Computer output would be enclosed in
      <command>computeroutput</command> tags, as in the following
      sample.
    </para>
<screen>
<userinput><command>grep snmptrap /etc/services</command></userinput>
<computeroutput>snmptrap        162/udp         snmp-trap       # Traps for=
 SNMP</computeroutput>
</screen>
    <para>
      Lines should be broken <emphasis>exactly</emphasis> as they are
      on-screen. Also, note that spaces inside <command>screen</command> ta=
gs
      are automatically treated as non-breaking.
    </para>
    <tip>
      <title>Fill modes and <command>screen</command> tags</title>
      <para>
  Using automatic or manual fill commands in Emacs/PSGML will sometimes
  mangle <command>screen</command> sections. Use care when performing fill
  operations, and check the results.
      </para>
    </tip>
  </section>

  <section>
    <title>Callout Example</title>
      <programlisting id=3D"pl-callout">
Line 1 <co id=3D"pl-callout-L1"/>
Line 2
Line 3
Line 4 <co id=3D"pl-callout-L4"/>
      </programlisting>
      <calloutlist>
        <callout arearefs=3D"pl-callout-L1">
          <para>
            Here is a callout.
          </para>
        </callout>
        <callout arearefs=3D"pl-callout-L4">
          <para>
            The second callout.
          </para>
        </callout>
      </calloutlist>
  </section>

<index id=3D"generated-index"></index>
</article>

<!--
Local variables:
mode: xml
End:
-->


Index: Makefile
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
RCS file: /cvs/docs/example-tutorial/Makefile,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- Makefile	27 Nov 2005 15:42:01 -0000	1.18
+++ Makefile	27 Nov 2005 17:57:23 -0000	1.19
@@ -9,7 +9,7 @@
 ##########################################################################=
#####
 # There is actually no "de" translation.  All the '*-de*" files are just
 # fodder to check the internationalization (i18n) workings for the FTP.
-# No discourtesey to an Germanic speaker is intended.  -- Tommy Reynolds
+# No discourtesy to any German speaker is intended.  -- Tommy Reynolds
 ##########################################################################=
#####
 #
 # Document-specific definitions.
@@ -21,7 +21,7 @@
 XMLEXTRAFILES-en=3D
 #
 DOCTITLE-de	=3D Beispiel Tutorial
-XMLEXTRAFILES-de=3D
+XMLEXTRAFILES-de=3D =

 #
 ######################################################
 include ../docs-common/Makefile.common
@@ -38,8 +38,10 @@
 =

 ######################################################
 #
+# Note xmlformat eliminates need to munge pretty XSL
+#
 #article-info-en.xml:: rpm-info.xml
-#	xsltproc -o $@ --stringparam doctype articleinfo ../docs-common/packagin=
g/bookinfo.xsl rpm-info.xml
+#	xsltproc --stringparam doctype articleinfo ../docs-common/packaging/book=
info.xsl rpm-info.xml | ../docs-common/bin/xmlformat -f ../docs-common/bin/=
xmlformat-fdp.conf > $@
 #
 #clean::
 #	${RM} bookinfo.xml
@@ -47,42 +49,53 @@
 =

 ######################################################
 # Some packaging specific vars
-VERSION=3D$(shell grep BOOKID $(DOCBASE)-en.xml | sed 's/<!ENTITY BOOKID "=
[^0-9\.]\+//' | sed 's/ .\+//')
-DATE=3D${shell grep BOOKID $(DOCBASE)-en.xml | sed 's/.\+(//' | sed 's/).\=
+//' }
+
+# These are obviated by new standard
+#VERSION=3D$(shell grep BOOKID $(DOCBASE)-en.xml | sed 's/<!ENTITY BOOKID =
"[^0-9\.]\+//' | sed 's/ .\+//')
+DATE=3D$(shell grep BOOKID $(DOCBASE)-en.xml | sed 's/.\+(//' | sed 's/).\=
+//')
+VERSION=3D$(shell grep " BOOKVERSION" $(DOCBASE)-en.xml | sed 's/.\+"\([0-=
9\.]\+\)".\+/\1/' )
 NOW=3D$(shell date +"%a %b %e %Y")
 SPECIN=3D../docs-common/packaging/fedora-doc.spec.in.common
 OMFIN=3D../docs-common/packaging/fedora-doc.omf.in.common
 DESKTOPIN=3D../docs-common/packaging/fedora-doc.desktop.in.common
-DOCSPEC=3D$(PWD)/SPECS/$(DOCBASE).spec
-DOCOMF=3D$(PWD)/SOURCES/fedora-doc-$(DOCBASE)-C.omf
-DOCDESKTOP=3D$(PWD)/SOURCES/fedora-doc-$(DOCBASE).desktop
-DOCSRCTAR=3D$(PWD)/SOURCES/$(DOCBASE)-$(VERSION).src.tar.gz
+DOCSPEC=3D$(PWD)/$(DOCBASE).spec.in
+DOCOMF=3D$(PWD)/fedora-doc-$(DOCBASE)-C.omf
+DOCDESKTOP=3D$(PWD)/fedora-doc-$(DOCBASE).desktop
+DOCSRCTAR=3D$(PWD)/$(DOCBASE)-$(VERSION).src.tar.gz
 TITLE=3D$(shell ../docs-common/packaging/titlegrab.py $(DOCBASE)-en.xml | =
sed 's/^ \+//')
 ######################################################
 # Some RPM flags...
 ######################################################
-RPMFLAGS=3D--define "docbase $(DOCBASE)" --define "version $(VERSION)" --d=
efine "_topdir $(PWD)"
+RPMFLAGS=3D--define "docbase $(DOCBASE)" --define "version $(VERSION)" --d=
efine "lang $(1)" --define "_topdir $(PWD)" --define "_rpmfilename %%{NAME}=
-$(1)-%%{VERSION}-%%{RELEASE}.%%{ARCH}.rpm" --define "_sourcedir $(PWD)" --=
define "_rpmdir $(PWD)" --define "_specdir $(PWD)"
 ######################################################
 =

-
-clean::
-	rm -rf fedora-doc-$(DOCBASE)*.rpm
-
-
-rpm: clean
-#
-# Make RPM-compliant tarball of source XML and other stuff
+$(DOCBASE)-$(VERSION).src.tar.gz::  tarball
 	mkdir $(DOCBASE)-$(VERSION)
-	find . -maxdepth 1 -type f ! \( -name '*~' -o -name 'Makefile*' \) \
+	find . -maxdepth 1 -type f ! \( -name '*~' -o -name 'Makefile*' \
+		-o -name '$(DOCBASE)*.tar.gz' \) \
 		| cpio -pamdv $(DOCBASE)-$(VERSION)
 	find . -maxdepth 1 -type d ! \( -name '$(DOCBASE)-$(VERSION)' \
 		-o -name 'CVS' -o -name '*~' -o -name '$(DOCBASE)*' \) \
 		| cpio -pamdv $(DOCBASE)-$(VERSION)
-#
-# Make RPM build tree; don't rely on local user's setup
-	mkdir -p {BUILD,RPMS/noarch,SOURCES,SPECS,SRPMS}
-	tar -zcvf $(DOCSRCTAR) $(DOCBASE)-$(VERSION)
+	( cd $(DOCBASE)-$(VERSION) ; tar xzf ../$(DOCBASE)-$(VERSION).tar.gz )
+	pwd
+	tar -zcvf $(DOCBASE)-$(VERSION).src.tar.gz $(DOCBASE)-$(VERSION)/
 	rm -rf $(DOCBASE)-$(VERSION)/
+
+
+#$(DOCBASE)-$(1)-clean::
+clean::
+	${RM} -rf fedora-doc-$(DOCBASE)*.rpm
+	${RM} -rf $(DOCBASE)-$(VERSION)*.src.tar.gz
+	${RM} -rf BUILD/ $(DOCBASE)-$(VERSION)/
+	${RM} -f *omf *desktop *spec.in
+
+
+define rpm_template
+rpm-$(1)::  clean $(DOCBASE)-$(VERSION).src.tar.gz
+# depend on source tarball and lang-specific HTML tarball
+# Make RPM build tree; don't rely on local user's setup
+	mkdir -p BUILD
 #
 # Make rpmlint happy with a changelog entry
 # FIXME: Maybe more magic would make this stickier; pity
@@ -105,8 +118,16 @@
 #
 # Do the build...
 #
-	rpmbuild -bb $(RPMFLAGS) $(DOCSPEC)
-	mv RPMS/noarch/*.rpm .
+	rpmbuild -bb $(RPMFLAGS) \
+		$(DOCSPEC)
 	rpmbuild --clean --rmsource $(RPMFLAGS) $(DOCSPEC)
-	rm -rf {BUILD,RPMS,SOURCES,SPECS,SRPMS}
-	rm -rf $(DOCBASE)-$(VERSION)
+#	rm -rf {BUILD,RPMS,SOURCES,SPECS,SRPMS}
+#	rm -rf $(DOCBASE)-$(VERSION)
+endef
+
+rpm::	$(foreach LANG,$(LANGUAGES),rpm-$(LANG))
+
+$(foreach LANG,${LANGUAGES},$(eval $(call rpm_template,${LANG})))
+
+showvars::
+	@echo "VERSION=3D$(VERSION)"


Index: rpm-info.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
RCS file: /cvs/docs/example-tutorial/rpm-info.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- rpm-info.xml	26 Nov 2005 21:44:18 -0000	1.2
+++ rpm-info.xml	27 Nov 2005 17:57:23 -0000	1.3
@@ -3,8 +3,19 @@
 <!-- Sample document description from which we build RPMs -->
 <!DOCTYPE rpm-info SYSTEM "../docs-common/packaging/rpm-info.dtd">
 <rpm-info>
-  <author email=3D"tcf(a)redhat.com" firstname=3D"Tammy" initials=3D"TCF" =
surname=3D"Fox" wholename=3D"Tammy Fox"/>
-  <editor email=3D"stickster(a)gmail.com" firstname=3D"Paul" surname=3D"Fr=
ields" wholename=3D"Paul W. Frields"/>
+  <author>
+    <wholename>Tammy Fox</wholename>
+    <email>tcf(a)redhat.com</email>
+    <surname>Fox</surname>
+    <firstname>Tammy</firstname>
+    <initials>TCF</initials>
+  </author>
+  <editor>
+    <wholename>Paul W. Frields</wholename>
+    <email>stickster(a)gmail.com</email>
+    <surname>Frields</surname>
+    <firstname>Paul</firstname>
+  </editor>
   <license>
     <rights>GNU FDL</rights>
     <version>1.0</version>
@@ -17,21 +28,27 @@
   <titles>
     <translation lang=3D"en">
       <title>Example Tutorial</title>
-      <desc>This is quite a feat.</desc>
+      <desc>An example tutorial for use with the Fedora Documentation Proj=
ect.</desc>
     </translation>
     <translation lang=3D"de">
-      <title>Beispeil Tutorial</title>
-      <desc>Ist idiotien</desc>
+      <title>Beispieltutorial</title>
+      <desc>Ein Beispieltutorial f=EF=BF=BD=EF=BF=BDr Gebrauch mit dem Unt=
erlagenprojekt Fedora.</desc>
     </translation>
   </titles>
   <changelog order=3D"newest-first">
-    <revision date=3D"Sat 26 Nov 2005" release=3D"2" version=3D"1.0.0" rol=
e=3D"rpm">
-      <author email=3D"me(a)home.net" firstname=3D"Me" initials=3D"I" surn=
ame=3D"Myself" wholename=3D"Me Myself"/>
+    <pkgrevision>
+      <date>Sat 26 Nov 2005</date>
+      <pkgversion>1.0.0</pkgversion>
+      <pkgrelease>2</pkgrelease>
+      <wholename>Paul W. Frields</wholename>
+      <email>stickster(a)gmail.com</email>
       <details>Some rpm-only changes</details>
-    </revision>
-    <revision date=3D"2005-09-18" release=3D"1" version=3D"0.13">
-      <author email=3D"stickster(a)gmail.com" firstname=3D"Paul" initials=
=3D"PWF" surname=3D"Frields" wholename=3D"Paul W. Frields"/>
+    </pkgrevision>
+    <docrevision>
+      <date>2005-09-18</date>
+      <docversion>0.13</docversion>
+      <initials>PWF</initials>
       <details>Add revision history</details>
-    </revision>
+    </docrevision>
   </changelog>
 </rpm-info>


--- example-tutorial-it.xml DELETED ---


--===============2327365198172800251==--