[Debtags-commits] [svn] r932 - in debtags/trunk: . debian
Enrico Zini
debtags-commits@lists.alioth.debian.org
Sat, 18 Jun 2005 18:06:16 +0000
Author: enrico
Date: Sat Jun 18 18:06:15 2005
New Revision: 932
Added:
debtags/trunk/DONE
Removed:
debtags/trunk/TODO
Modified:
debtags/trunk/README
debtags/trunk/configure.ac
debtags/trunk/debian/changelog
debtags/trunk/debian/docs
Log:
Bumped version to 1.0; merged TODO into the README
Modified: debtags/trunk/README
==============================================================================
--- debtags/trunk/README (original)
+++ debtags/trunk/README Sat Jun 18 18:06:15 2005
@@ -1,13 +1,245 @@
+README for debtags 1.0
+======================
+
+Functionality
+-------------
+
+debtags is the commandline maintenance and query tool for Debtags. It can be
+used to download up-to-date tag database and vocabulary, to query them, to edit
+the categorization and to submit the changes to the central repository.
+
+
+What is in this release
+-----------------------
+
+debtags has been ported to libdebtags1 1.0.3 and most uses of Package have been
+replaced with uses of std::string, with a noticeable performance increse.
+
+
+Compiling from the subversion repository
+----------------------------------------
+
+Additionally to the build-dependencies, you need to install ``libtool`` and
+``automake1.9`::
+
+ apt-get install libtool automake1.9
+ ./autogen.sh
+ ./configure
+ make
+
+The program uses GNU Libtool. While this is very nice, it can be a pain when
+trying to debug a program. For that reason, compilation of shared libraries can
+be turned off by specifying the ``--disable-shared`` option to ``configure``.
+
+
+Resources
+---------
+
+ Website:
+
+ http://debtags.alioth.debian.org
+
+ Mailing lists:
+
+ debtags-devel@lists.alioth.debian.org
+ http://lists.alioth.debian.org/mailman/listinfo/debtags-devel
+ Development and usage discussions
+
+ debtags-commits@lists.alioth.debian.org
+ http://lists.alioth.debian.org/mailman/listinfo/debtags-commmits
+ Postings of subversion logs
+
+ Subversion repository:
+
+ http://svn.debian.org/viewcvs/debtags/libdebtags
+ Browse online
+ svn://svn.debian.org/debtags/libdebtags
+ Read-only access
+ svn+ssh://alioth.debian.org/svn/debtags/libdebtags
+ Write access
+
+ APT repository:
+
+ deb http://debtags.alioth.debian.org/debian unstable main
+
+
+Further stages of the development
+---------------------------------
+
+Development will now proceed by:
+
+ * Keeping pace with libdebtags1 development, to keep having an up-to-date
+ front-end to the library functions
+ * Providing more and improvement statistics
+
+
+TODO-list items completed so far
+--------------------------------
+
+These are the TODO-list items completed so far::
+
+
+(older completed items are archived in the DONE file)
+
+
+
+TODO-list items being worked on
+-------------------------------
+
+These are the TODO-list items currently being worked on::
+
+ - todoreport should mention that the number of packages has been limited
+
+ - specials: given a facet A, for all other facets Bn generate a list of
+ packages that have A and not Bn
+
+ - generate one todoreport per maintainer
+
+ - debtags related does not work
+ ("debtags -d 14 related debtags" doesn't output anything
+
+ - Statistics and automated checks:
+ - Experiment with theory:
+ - there should never be two packages with the same tagset: if it happens, a
+ new facet may need to be created
+ - Make a debtags function to detect when it happens
+
+ - Code
+ - In debtags update, print the names of packages that are not in the debtags
+ archive
+ - On debtags update, filter out tag data for packages not existing in the
+ system
+ - On debtags update, output a list of the packages not present in the tag collection
+ - Usare "foreign" nell'inizializzazione di automake, in modo che non richieda il changelog
+ (e cancellare il changelog) (anche negli altri pacchetti)
+ - Make a CommandlineParserWithCommands supporting command-specific switches:
+ addCmdSwitch("command", <same args as add()>)
+ addCmdSwitch("", ..) adds a switch that gets interpreted when no valid
+ command is found
+ The option parsing should then scan until it finds the first non-option
+ argument and see if it's a command, then re-scan the commandline with the
+ good set of switches in effect. There's a problem in this with arguments
+ to short switches, like '-o file': `file' could be interpreted as a
+ command and not as an option to `-o'. Could be solved by having all
+ switches be considered when scanning for the command, or (better) by
+ scanning once for each command until a valid match is found
+
+ - debtags install: Allow to call aptitude instead of apt-get
+
+ - [erich] I had the idea that people can "adopt" a keyword, looking for
+ volunteers to review a section regularly.
+
+
+Future TODO-list items
+----------------------
+
+These are the TODO-list items that are to be addressed in the future::
+
+ - Merging different tag sources
+ - Scenario: I want to edit tags when I have multiple tag sources, submitting
+ appropriate, separate tag patches to the tag sources which are in charge of
+ the tags that changed.
+ - Including a local, user defined, tag hierarchy (preference::interesting,
+ preference::useless, preference::tried...)
+ - Add origin to facets and save a different patch for every origin
+ - [me]
+ It could be interesting to outsource the first tag layout of such parts
+ to the relative communities: for example, we could ask the gnome people
+ to provide the right tag vocabulary for gnome-related qualities.
+ I guess they may be happy to do it (and to be kept in consideration by
+ the Debian people), and surely they know what are right qualities in
+ their world.
+ - Add Extends: apt to control file (like guessnet does with ifupdown)
+ - Allow to manipulate a local vocabulary (~/.debtags/vocabulary ?)
+
+ - Integrate with APT
+ - See if it's possible to hook debtags update after apt-get update
+ - Patch apt-cache to exec debtags for some things (when debtags is installed)
+ [zufus]
+
+ - When adding new tags to the vocabulary, announce them to debian-devel
+ (no faster than weekly)
+ - Maintain an upgrade checklist for the vocabulary. cvs diff can help
+ generating it
+
+ - Since we're somehow similar to semantic web, have a look at what it is, how
+ it works and how crossing that path can be useful
+
+ - Navigazione: l'utente induce nella tagged collection una struttura a lui
+ specifica, avvicinando categorie e allontanandone altre. Questo può anche
+ essere mappato bi o tridimensionalmente, con animazione.
+
+ - Erich:
+ This to improve in synaptic-debtags:
+ - make the tree less deep, don't make subfolders if only < 10 packages are
+ left etc.
+ - show tag descriptions.
+ - handle "virtual" tags in the tree, such as "ui", which basically is a
+ union of "ui::gtk", "ui::qt", "ui::ncurses" etc. (virtual tags: tags
+ where all packages are in a subgroup)
+
+ Things to improve with debtags in general:
+ - more tagging. Too many packages are still untagged
+ - inconsistent tagging. New tags were added, so many tagged packages are
+ incompletely tagged. For example many applications don't have a user
+ interface specified.
+ - inconsistent tags. some features have tags, others don't.
+ - structure is becoming to deep IMHO. but if you want to keep the
+ number-of-results low you need such a deep structure.
+
+ - [Javier Fernández-Sanguino Peña]
+ Have a look at TFIDF systems (implemented in bow) to use them to find out tags.
+ The suggestion comes from Javier Fernández-Sanguino Peña <jfs@computer.org>,
+ who's happy to help with problems understanding TFIDF
+ - Ask for someone in the i18n team to join in, to help with the design of the
+ language dependent files with tag names and descriptions.
+
+
+
+Discarded TODO-list items
+-------------------------
+
+These TODO-list items have been discarded::
+
+ = Note to the vocabulary task force: "mail,net" is a single tag, "mail, net"
+ are two tags
+ (this is an old note that doesn't make much sense anymore)
+ = Note to the vocabulary task force: rub "debtags check" from time to time
+ (this is an old note that doesn't make much sense anymore)
+ = [chlunde] Don't crash when giving data about a non-existing package: it
+ might happen, such as when using the full database on a system without
+ non-free. Don't show the application, instead.
+ [chlunde is working on it]
+ (old note, fixed since long time on debtags-edit)
+
+(older discarded items are archived in the DONE file)
+
+
+Miscellaneous notes
+-------------------
+
Some analysis techniques:
-Consistency checks on facets that should go together:
+Consistency checks on facets that should go together::
+
+ # Show all packages which have a tag in uitoolkit but not a tag in interface
+ # (same can be repeated for hardware and hwtech, devel and langdevel)
+ debtags facetcoll | grep uitoolkit | grep -v interface | cut -d: -f1 | sort | uniq
+
+ # Count the number of facets
+ debtags facetcoll | tagcoll reverse | wc -l
+
+ # Get a list of toplevel facets in a facet hierarchy
+ debtags facetcoll | tagcoll hierarchy | cut -f2 -d/ | cut -f1 -d: | sort | uniq
+
+
+Interesting links:
+
+ * http://www.itconsult.it/knowledge/articoli/detArticoli.asp?ID=18
+
-# Show all packages which have a tag in uitoolkit but not a tag in interface
-# (same can be repeated for hardware and hwtech, devel and langdevel)
-debtags facetcoll | grep uitoolkit | grep -v interface | cut -d: -f1 | sort | uniq
-# Count the number of facets
-debtags facetcoll | tagcoll reverse | wc -l
+Author
+------
-# Get a list of toplevel facets in a facet hierarchy
-debtags facetcoll | tagcoll hierarchy | cut -f2 -d/ | cut -f1 -d: | sort | uniq
+Enrico Zini <enrico@debian.org>
Modified: debtags/trunk/configure.ac
==============================================================================
--- debtags/trunk/configure.ac (original)
+++ debtags/trunk/configure.ac Sat Jun 18 18:06:15 2005
@@ -1,4 +1,4 @@
-AC_INIT(debtags, 0.2, [enrico@debian.org])
+AC_INIT(debtags, 1.0, [enrico@debian.org])
AC_CONFIG_SRCDIR([configure.ac])
AM_CONFIG_HEADER(config.h)
AM_INIT_AUTOMAKE
Modified: debtags/trunk/debian/changelog
==============================================================================
--- debtags/trunk/debian/changelog (original)
+++ debtags/trunk/debian/changelog Sat Jun 18 18:06:15 2005
@@ -1,3 +1,9 @@
+debtags (1.0) experimental; urgency=low
+
+ * Bumped version to 1.0
+
+ -- Enrico Zini <enrico@debian.org> Sat, 18 Jun 2005 19:50:07 +0200
+
debtags (0.2) experimental; urgency=low
* Ported to use DebtagsSimple instead of Environment
Modified: debtags/trunk/debian/docs
==============================================================================
--- debtags/trunk/debian/docs (original)
+++ debtags/trunk/debian/docs Sat Jun 18 18:06:15 2005
@@ -1,3 +1,4 @@
-TODO
+README
+DONE
doc/faq.rst
doc/paper-debtags.rst