[GNUnet-SVN] r696 - in Extractor: . doc

[grothoff]

Author: grothoff
Date: 2005-04-26 12:16:28 -0700 (Tue, 26 Apr 2005)
New Revision: 696

Modified:
   Extractor/configure.ac
   Extractor/doc/extract.1
   Extractor/doc/libextractor.3
Log:
updates

Modified: Extractor/configure.ac
===================================================================
--- Extractor/configure.ac      2005-04-25 22:26:05 UTC (rev 695)
+++ Extractor/configure.ac      2005-04-26 19:16:28 UTC (rev 696)
@@ -1,6 +1,6 @@
 # Process this file with autoconf to produce a configure script.
 AC_PREREQ(2.57)
-AC_INIT([libextractor], [0.4.2], address@hidden)
+AC_INIT([libextractor], [0.4.2], address@hidden)
 AC_REVISION($Revision: 1.67 $)
 AM_INIT_AUTOMAKE([libextractor], [0.4.2])
 AM_CONFIG_HEADER(src/include/config.h)

Modified: Extractor/doc/extract.1
===================================================================
--- Extractor/doc/extract.1     2005-04-25 22:26:05 UTC (rev 695)
+++ Extractor/doc/extract.1     2005-04-26 19:16:28 UTC (rev 696)
@@ -1,4 +1,4 @@
-.TH EXTRACT 1 "December 25, 2004" "libextractor 0.4.0"
+.TH EXTRACT 1 "April 28, 2005" "libextractor 0.4.2"
 .\" $Id
 .SH NAME
 extract
@@ -14,7 +14,7 @@
 ]
 [
 .B \-H
-.I hash-algorithm
+.I hash\-algorithm
 ]
 [
 .B \-l
@@ -37,10 +37,10 @@
 command.
 .PP
 .B extract
-tests each file specified in the argument list in an attempt to infer 
meta-information from it.  Each file is subjected to the meta-data extraction 
libraries from 
+tests each file specified in the argument list in an attempt to infer 
meta\-information from it.  Each file is subjected to the meta\-data extraction 
libraries from 
 .I libextractor. 
 .PP
-libextractor classifies meta-information (also referred to as keywords) into 
types. A list of all types can be obtained with the 
+libextractor classifies meta\-information (also referred to as keywords) into 
types. A list of all types can be obtained with the 
 .B \-L 
 option. 
 
@@ -55,7 +55,7 @@
 option
 .TP 8
 .B \-B LANG
-Use the generic plaintext extractor for the language with the 2-letter 
language code LANG.  Supported languages are DA (Danish), DE (German), EN 
(English), ES (Spanish), IT (Italian) and NO (Norwegian).
+Use the generic plaintext extractor for the language with the 2\-letter 
language code LANG.  Supported languages are DA (Danish), DE (German), EN 
(English), ES (Spanish), IT (Italian) and NO (Norwegian).
 .TP 8
 .B \-d
 Remove duplicates only if the types match exactly. By default, duplicates are 
removed if the types match or if one of the types is \I unknown (in this case, 
the duplicate of unknown type is removed).
@@ -73,13 +73,13 @@
 Print a list of all known keyword types.
 .TP 8
 .B \-n
-Do not use the default set of extractors (typically all standard extractors, 
currently mp3, ogg, jpg, gif, png, tiff, real, html, pdf and mime-types), use 
only the extractors specified with the .B \-l option.
+Do not use the default set of extractors (typically all standard extractors, 
currently mp3, ogg, jpg, gif, png, tiff, real, html, pdf and mime\-types), use 
only the extractors specified with the .B \-l option.
 .TP 8
 .B \-r
 Remove all duplicates disregarding differences in the keyword type.
 .TP 8
 .B \-s
-Split keywords at delimiters (space, comma, colon, etc.) and list split 
keywords to be of .I unknown type. This can also be done by loading the 
split-library. Using this option guarantees that the splitting is performed 
after all other libraries have been run. It is always performed before 
duplicate elimination.
+Split keywords at delimiters (space, comma, colon, etc.) and list split 
keywords to be of .I unknown type. This can also be done by loading the 
split\-library. Using this option guarantees that the splitting is performed 
after all other libraries have been run. It is always performed before 
duplicate elimination.
 .TP 8
 .B \-v
 Print the version number and exit.
@@ -91,7 +91,7 @@
 Run the printable extractor (costly, generic extractor for binaries)
 .TP 8
 .BI \-l " libraries"
-Use the specified libraries to extract keywords. The general format of 
libraries is .I [[-]LIBRARYNAME[:[-]LIBRARYNAME]*] where LIBRARYNAME is a 
libextractor compatible library and typically of the form .I 
libextractor_jpeg.so\. The minus before the libraryname indicates that this 
library should be run after all the libraries that were specified so far. If 
the minus is missing, the library is run before all previously specified 
libraries. 
+Use the specified libraries to extract keywords. The general format of 
libraries is .I [[\-]LIBRARYNAME[:[\-]LIBRARYNAME]*] where LIBRARYNAME is a 
libextractor compatible library and typically of the form .I 
libextractor_jpeg.so\. The minus before the libraryname indicates that this 
library should be run after all the libraries that were specified so far. If 
the minus is missing, the library is run before all previously specified 
libraries. 
 .TP 8
 .BI \-p " type"
 Print only the keywords matching the specified type. By default, all keywords 
that are found and not removed as duplicates are printed.
@@ -105,32 +105,32 @@
 .SH EXAMPLES
 .nf
 $ extract test/test.jpg
-comment - (C) 2001 by Christian Grothoff, using gimp 1.2 1
-mimetype - image/jpeg
+comment \- (C) 2001 by Christian Grothoff, using gimp 1.2 1
+mimetype \- image/jpeg
 
-$ extract -Vf -x comment test/test.jpg
+$ extract \-Vf \-x comment test/test.jpg
 Keywords for file test/test.jpg:
-mimetype - image/jpeg
-filename - test.jpg
+mimetype \- image/jpeg
+filename \- test.jpg
 
-$ extract -p comment test/test.jpg
-comment - (C) 2001 by Christian Grothoff, using gimp 1.2 1
+$ extract \-p comment test/test.jpg
+comment \- (C) 2001 by Christian Grothoff, using gimp 1.2 1
 
-$ extract -nV -l libextractor_png.so -p comment test/test.jpg test/test.png
+$ extract \-nV \-l libextractor_png.so \-p comment test/test.jpg test/test.png
 Keywords for file test/test.jpg:
 Keywords for file test/test.png:
-comment - Testing keyword extraction
+comment \- Testing keyword extraction
 
 .SH LEGAL NOTICE
-libextractor and the extract tool are released under the GPL.
+libextractor and the extract tool are released under the GPL.  libextractor is 
a GNU project.
 
 .SH BUGS
-A couple of file-formats (on the order of 10^3) are not recognized...
+A couple of file\-formats (on the order of 10^3) are not recognized...
 
 .SH AUTHORS
 .B extract
 was originally written by Christian Grothoff <address@hidden> and
-Vidyut Samanta <address@hidden>. Use <address@hidden>
+Vidyut Samanta <address@hidden>. Use <address@hidden>
 to contact the current maintainer(s).
 
 .SH AVAILABILITY

Modified: Extractor/doc/libextractor.3
===================================================================
--- Extractor/doc/libextractor.3        2005-04-25 22:26:05 UTC (rev 695)
+++ Extractor/doc/libextractor.3        2005-04-26 19:16:28 UTC (rev 696)
@@ -48,7 +48,7 @@
 
 .SH DESCRIPTION
 .P
-libExtractor is a simple library for keyword extraction.  libExtractor does 
not support all formats but supports a simple plugging mechanism such that you 
can quickly add extractors for additional formats, even without recompiling 
libExtractor.  libExtractor typically ships with one or more helper-libraries 
that can be used to obtain keywords from common file-types.  If you want to 
write your own extractor for some filetype, all you need to do is write a 
little library that implements a single method with this signature:
+libextractor is a simple library for keyword extraction.  libExtractor does 
not support all formats but supports a simple plugging mechanism such that you 
can quickly add extractors for additional formats, even without recompiling 
libExtractor.  libExtractor typically ships with one or more helper-libraries 
that can be used to obtain keywords from common file-types.  If you want to 
write your own extractor for some filetype, all you need to do is write a 
little library that implements a single method with this signature:
 
  \fBEXTRACTOR_KeywordList * LIBRARYNAME_extract(const char * \fIfilename\fB,
                                              char * \fIdata\fB,
@@ -67,13 +67,13 @@
 extract(1)
 
 .SH LEGAL NOTICE
-libextractor is released under the GPL.
+libextractor is released under the GPL and a GNU project (http://www.gnu.org/).
 
 .SH BUGS
 A couple of file-formats (on the order of 10^3) are not recognized...
 
 .SH AUTHORS
-extract was originally written by Christian Grothoff <address@hidden> and 
Vidyut Samanta <address@hidden>. Use <address@hidden> to contact the current 
maintainer(s).
+extract was originally written by Christian Grothoff <address@hidden> and 
Vidyut Samanta <address@hidden>. Use <address@hidden> to contact the current 
maintainer(s).
 
 .SH AVAILABILITY
 You can obtain the original author's latest version from 
http://gnunet.org/libextractor/.