From 26e6ade8342194e6f5648a7a94408ddbb69b83f8 Mon Sep 17 00:00:00 2001 From: John Darrington Date: Wed, 22 Aug 2012 15:08:21 +0200 Subject: [PATCH] Documentation: replace GNU with @acronym{GNU} --- ChangeLog | 4 +++ doc/recutils.texi | 56 ++++++++++++++++++++++++++-------------------------- 2 files changed, 32 insertions(+), 28 deletions(-) diff --git a/ChangeLog b/ChangeLog index c0b9417..a539488 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +2012-08-22 John Darrington + + * doc/recutils: Replace GNU with @acronym{GNU} + 2012-08-16 John Darrington doc: Reals always use the dot as separator diff --git a/doc/recutils.texi b/doc/recutils.texi index a85d865..f0c6ac7 100644 --- a/doc/recutils.texi +++ b/doc/recutils.texi @@ -2,7 +2,7 @@ @comment %**start of header @setfilename recutils.info @include version.texi address@hidden GNU Recutils address@hidden @acronym{GNU} Recutils @afourpaper @comment %**end of header @@ -12,7 +12,7 @@ @end macro @copying -This manual is for GNU recutils (version @value{VERSION}, +This manual is for @acronym{GNU} recutils (version @value{VERSION}, @value{UPDATED}). Copyright @copyright{} 2009, 2010, 2011, 2012 Jose E. Marchesi @@ -21,17 +21,17 @@ Copyright @copyright{} 1994-2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or +under the terms of the @acronym{GNU} Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A -copy of the license is included in the section entitled ``GNU Free +copy of the license is included in the section entitled address@hidden Free Documentation License''. @end quotation @end copying @dircategory Database @direntry -* recutils: (recutils). The GNU Recutils manual. +* recutils: (recutils). The @acronym{GNU} Recutils manual. @end direntry @dircategory Individual utilities @@ -48,9 +48,9 @@ Documentation License''. @end direntry @titlepage address@hidden GNU recutils address@hidden @acronym{GNU} recutils @subtitle for version @value{VERSION}, @value{UPDATED} address@hidden GNU recutils Developers (@email{bug-recutils@@gnu.org}) address@hidden @acronym{GNU} recutils Developers (@email{bug-recutils@@gnu.org}) @page @vskip 0pt plus 1filll @insertcopying @@ -60,16 +60,16 @@ Documentation License''. @ifnottex @node Top address@hidden GNU Recutils address@hidden @acronym{GNU} Recutils -This manual documents version @value{VERSION} of the GNU recutils. +This manual documents version @value{VERSION} of the @acronym{GNU} recutils. @insertcopying @end ifnottex @menu Overview -* Introduction:: Introducing the GNU recutils. +* Introduction:: Introducing the @acronym{GNU} recutils. * A Little Example:: Recutils in action. The Basic Rec Format @@ -108,13 +108,13 @@ The Recutils * rec2csv:: Converting rec data into csv data. * mdb2rec:: Converting mdb files into rec files. -* GNU Free Documentation License:: Distribution terms for this document. +* @acronym{GNU} Free Documentation License:: Distribution terms for this document. @end menu @node Introduction @chapter Introduction -GNU recutils is a set of tools and libraries to access human-editable, address@hidden recutils is a set of tools and libraries to access human-editable, text-based databases called @emph{recfiles}. The data are stored as a sequence of records, each record containing an arbitrary number of named fields. Advanced capabilities usually found in other data @@ -163,7 +163,7 @@ hierarchies in recfiles) and performance is somewhat sacrificed in favor of readability. But they are quite handy to store small to medium simple databases. -The GNU recutils suite comprises: +The @acronym{GNU} recutils suite comprises: @itemize @minus @item This Texinfo manual, describing the Rec format and the accompanying software. @@ -188,7 +188,7 @@ previous section, is that the tool is too complicated for the simple task: we do not need the full power of a relational database system to maintain a simple collection of books. -With GNU recutils it is possible to maintain such a little database in +With @acronym{GNU} recutils it is possible to maintain such a little database in a text file. Let's call it @file{books.rec}. The following table resumes the information items that we want to store for each title, along with some common-sense restrictions. @@ -226,7 +226,7 @@ The contents of the rec file follows: %doc: + A book in my personal collection. -Title: GNU Emacs Manual +Title: @acronym{GNU} Emacs Manual Author: Richard M. Stallman Publisher: FSF Location: home @@ -253,7 +253,7 @@ Location: home Simple. The file contains a set of records separated by blank lines. Each record is composed by a set of fields with a name and a value. -The GNU recutils can then be used to access the contents of the file. +The @acronym{GNU} recutils can then be used to access the contents of the file. For example, we could get a list of the names of loaned books by invoking @command{recsel} in the following way: @@ -398,7 +398,7 @@ kind of markers: # # TODO # -# This file contains the Bugs database of GNU recutils. +# This file contains the Bugs database of @acronym{GNU} recutils. # # Blah address@hidden @@ -612,7 +612,7 @@ The record descriptor above is including the contents of the the local record descriptor, that in this case contains just the @code{%mandatory} field. -If you are using the GNU recutils to process your recfiles, any URL +If you are using the @acronym{GNU} recutils to process your recfiles, any URL schema supported by @code{libcurl} will work. @node %mandatory and %prohibit @@ -1098,7 +1098,7 @@ That is useful in some cases such as: @noindent The regexp flavor supported in recfiles are the POSIX EREs plus -several GNU extensions. @xref{Regular Expressions}. +several @acronym{GNU} extensions. @xref{Regular Expressions}. @node Enumerated types @section Enumerated types @@ -1381,7 +1381,7 @@ database does not mean that the database will be always physically ordered. Unsorted record sets are not a data integrity problem, and thus the diagnosis tools must not declare a recfile as invalid because of this. Some tools may provide a way to physically -order the fields in the file. That is certainly the case of the GNU +order the fields in the file. That is certainly the case of the @acronym{GNU} recutils, where @command{recfix} can be used for that purpose. @xref{recfix}. @@ -1675,7 +1675,7 @@ among all the webmasters, and the ShellPassword entries with a more restricted password available only to the administrator of the machine. -The GNU recutils fully support encrypted fields. See the documentation +The @acronym{GNU} recutils fully support encrypted fields. See the documentation for @code{recsel}, @code{recins} and @code{recfix} for details on how to operate on files containing confidential fields. @@ -1701,7 +1701,7 @@ matches a @samp{?}. Bracket expressions are used to match ranges of characters. Bracket expressions where the range is backward, for example @samp{[z-a]}, are invalid. Within square brackets, @samp{\} is taken literally. Character classes are supported; for example @samp{[[:digit:]]} will match a single decimal digit. -GNU extensions are supported: address@hidden extensions are supported: @enumerate @item @samp{\w} matches a character within a word @@ -1907,7 +1907,7 @@ Email: foo@@foo.org @end example The regexp flavor supported in selection expressions are the POSIX -EREs plus several GNU extensions. @xref{Regular Expressions}. +EREs plus several @acronym{GNU} extensions. @xref{Regular Expressions}. @subsubsection Parenthesized Expressions @@ -1960,7 +1960,7 @@ Strings can be compared with the equality operator (@code{=}). The match operator (@code{~}) can be used to match a string with a given regular expression. The supported regexp syntax is described in -the GNU C library manual. +the @acronym{GNU} C library manual. @subsubsection Date Comparison Operators @@ -3433,7 +3433,7 @@ $ mdb2rec sales.mdb Products %type: Discontinued bool ProductID: 1 -ProductName: GNU generation T-shirt +ProductName: @acronym{GNU} generation T-shirt Discontinued: 0 @dots{} @@ -3452,7 +3452,7 @@ $ mdb2rec sales.mdb Customers %type: ContactName size 60 CustomerID: GSOFT -CompanyName: GNU Soft +CompanyName: @acronym{GNU} Soft ContactName: Jose E. Marchesi @dots{} @@ -3474,8 +3474,8 @@ $ mdb2rec sales.mdb @dots{} @end example address@hidden GNU Free Documentation License address@hidden GNU Free Documentation License address@hidden @acronym{GNU} Free Documentation License address@hidden @acronym{GNU} Free Documentation License @include fdl.texi -- 1.7.2.5