From 3dd6d2ce5083791e0574668e2d2b76d32b248ed8 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 7 Nov 2008 01:22:49 +0000 Subject: xstring 1.4, and ignore its stale .tds.zip (4nov08) git-svn-id: svn://tug.org/texlive/trunk@11208 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/generic/xstring/README | 97 ++++++++++++++++++++++++++++ 1 file changed, 97 insertions(+) create mode 100644 Master/texmf-dist/doc/generic/xstring/README (limited to 'Master/texmf-dist/doc/generic/xstring/README') diff --git a/Master/texmf-dist/doc/generic/xstring/README b/Master/texmf-dist/doc/generic/xstring/README new file mode 100644 index 00000000000..16b5f4bcfe5 --- /dev/null +++ b/Master/texmf-dist/doc/generic/xstring/README @@ -0,0 +1,97 @@ + _________________ + + xstring package + v1.4 + 2008/11/04 + _________________ + +------------------------------------------------------------------------------ + Warning! +This package does not require LaTeX (although eTeX is still required). +Consequently, the xstring.tex file should be installed in the tex/ subtree. +------------------------------------------------------------------------------ +This package provides macros manipulating strings for programming use. +A "string" is made of chars (catcodes 10, 11 and 12), controls sequences, +groups between braces, tokens with other catcodes excepted 6 and 14 (# and %). +Main features are: + * tests: + - does a string contains at least n times an another? + - does a string starts (or ends) with another? etc. + - is a string an integer? A decimal? + - are 2 strings equal? + - is a string equal to several cases? + * extractions of substrings: + - what is on the left (or the right) of the nth occurrence of a + substring; + - what is between the occurrences of 2 substrings; + - substring between 2 positions; + - split a string, etc. + * substitution of all (or the n first) occurrences of a substring + for an other substring; + * calculation of numbers: + - length of a string; + - position of the nth occurrence of a substring; + - how many times a string contains a substring? + - comparison of strings: position of the first difference. + +For advanced programming needs, other macros allow to use other special +characters forbiden in strings (# %). + +This bundle contains 11 files: + * xstring.sty (the sty file for LaTeX) + * xstring.tex (the package itself) + * xstring_doc_en.tex and xstring_doc_en.pdf (manual in english) + * xstring_doc_fr.tex and xstring_doc_fr.pdf (manual in french) + * test_etex.tex and test_etex.pdf (test file to compile with etex) + * test_latex.tex and test_latex.pdf (test file to compile with LaTeX) + * README (this file) + +############################################################################## +############################################################################## + +------------------------------------------------------------------------------ + Attention ! +Cette extension ne nécessite pas LaTeX (bien que eTeX soit toujours requis). +Par conséquent, le fichier xstring.tex devrait être installé dans le sous +répertoire tex/. +------------------------------------------------------------------------------ +Cette extension regroupe un ensemble de macros manipulant des chaînes à des +fins de programmation. +Une "chaine" pouvant contenir des caractères, des séquences de contrôle, des +groupes entre accolades et des lexèmes ayant d'autres catcodes excepté 6 et 14 +(# et %). +Les principales fonctionnalités sont : + * des tests : + - une chaîne en contient elle une autre au moins n fois ? + - une chaîne commence t-elle ou finit-elle par une autre ? etc. + - une chaîne est-elle un entier relatif ? Un décimal ? + - deux chaînes sont-elles égales ? + - une chaîne est elle égale à plusieurs cas ? + * des extractions de chaines : + - renvoi de ce qui se trouve avant (ou après) la nieme occurrence + d'une sous-chaîne; + - renvoi de ce qui se trouve entre les occurrences de 2 sous-chaînes; + - sous-chaîne comprise entre 2 positions; + - coupure d'une chaîne, etc. + * le remplacement de toutes ou des n premières occurrences d'une + sous-chaîne par une autre sous-chaîne; + * des calculs de nombres : + - longueur d'une chaîne; + - position de la la nieme occurrence d'une sous-chaîne; + - comptage du nombre d'occurrences d'une sous-chaîne dans une autre. + - comparaison de 2 chaînes : position du 1er caractère différent. + +Pour des méthodes de programmation avancées, d'autres commandes permettent +d'utiliser les caractères spéciaux interdits dans les chaines (# %). + +Ce paquet contient 11 fichiers : + * xstring.sty (le fichier sty pour LaTeX) + * xstring.tex (le package lui même) + * xstring_doc_en.tex and xstring_doc_en.pdf (manuel en anglais) + * xstring_doc_fr.tex and xstring_doc_fr.pdf (manuel en français) + * test_etex.tex and test_etex.pdf (fichier test à compiler avec etex) + * test_latex.tex and test_latex.pdf (fichier test à compiler avec LaTeX) + * README (ce fichier) + + Christian Tellechea + \ No newline at end of file -- cgit v1.2.3