[Debtags-commits] [svn] r2236 - in debtags/1.6.0: . doc

[Enrico Zini]

Author: enrico
Date: Thu Feb  8 22:19:08 2007
New Revision: 2236

Modified:
   debtags/1.6.0/   (props changed)
   debtags/1.6.0/doc/Makefile.am
   debtags/1.6.0/doc/faq.rst
   debtags/1.6.0/sources.list
Log:
 r3857 at viaza:  enrico | 2007-02-08 22:20:37 +0100
 FAQ updates
 More comments in sources.list about how to contribute and alioth tags tracking
   unstable (thanks to Justin B Rye)


Modified: debtags/1.6.0/doc/Makefile.am
==============================================================================
--- debtags/1.6.0/doc/Makefile.am	(original)
+++ debtags/1.6.0/doc/Makefile.am	Thu Feb  8 22:19:08 2007
@@ -22,7 +22,10 @@
 %.eps: %.png
 	convert $< $@
 
-web: paper-debtags.rst paper-debtags.html paper-debtags.pdf $(IMAGES)
+faq.html: faq.rst
+	rst2html --no-doc-title --stylesheet=main.css $< > $@
+
+web: paper-debtags.rst paper-debtags.html paper-debtags.pdf faq.html $(IMAGES)
 	scp $^ "alioth.debian.org:/org/alioth.debian.org/chroot/home/groups/debtags/htdocs/"
 else
 paper-debtags.html: paper-debtags.rst

Modified: debtags/1.6.0/doc/faq.rst
==============================================================================
--- debtags/1.6.0/doc/faq.rst	(original)
+++ debtags/1.6.0/doc/faq.rst	Thu Feb  8 22:19:08 2007
@@ -135,7 +135,7 @@
 
 
 What does a notation such as "works-with::image:raster" mean?
-------------------------------------------------------
+-------------------------------------------------------------
 
 It means that the facet (the point of view from which we look at the packages)
 is "works-with", and that the tag (what kind of data this package can handle) 
@@ -299,9 +299,11 @@
 How can I experiment writing applications using debtags?
 --------------------------------------------------------
 
-You can have a look at `libapt-front-dev`_, which allows access to both debtags
-and apt package data and is a really good C++ library.  Thanks to the work of
-Torsten Marek, it may soon have Python bindings.
+For C++, have a look at `libept-dev`_, which allows access to both
+debtags and apt package data.
+
+For Python, the `python-debian`_ package has a good ``debtags`` module and
+various interesting code examples.
 
 ..
  , which also has python__ and perl__
@@ -358,7 +360,9 @@
 .. _libapt-front: http://libapt-front.alioth.debian.org/
 .. _libdebtags1-dev: http://packages.debian.org/libdebtags1-dev
 .. _libapt-front-dev: http://packages.debian.org/libapt-front-dev
+.. _libept-dev: http://packages.debian.org/libept-dev
 .. _packagebrowser: http://debian.vitavonni.de/packagebrowser/
 .. _packagesearch: http://packagesearch.sourceforge.net/
 .. _theorical foundation: http://debtags.alioth.debian.org/faceted.html
 .. _Alioth project: http://debtags.alioth.debian.org/
+.. _python-debian: http://packages.debian.org/python-debian

Modified: debtags/1.6.0/sources.list
==============================================================================
--- debtags/1.6.0/sources.list	(original)
+++ debtags/1.6.0/sources.list	Thu Feb  8 22:19:08 2007
@@ -3,6 +3,8 @@
 # You can specify more than one; during update, debtags will merge the contents
 # of all the sources.  The merged data can be found in
 # /var/lib/debtags/package-tags and /var/lib/debtags/vocabulary.
+#
+# To contribute tags, please visit http://debtags.alioth.debian.org/todo.html
 
 # Reviewed tag data from the APT Packages file
 tags apt://
@@ -13,6 +15,12 @@
 
 
 # Regularly updated, but unchecked, database on the web
+#
+# If you plan to use Stable, please be aware that online tag
+# databases are more likely to track Testing/Unstable; so be careful
+# about downloading tags from them, and please check if tags are still
+# accurate for current package versions before contributing them upstream
+#
 #tags http://debtags.alioth.debian.org/tags/