summaryrefslogtreecommitdiffstats
path: root/templates/man5/locatedb.5.pot
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--templates/man5/locatedb.5.pot324
1 files changed, 324 insertions, 0 deletions
diff --git a/templates/man5/locatedb.5.pot b/templates/man5/locatedb.5.pot
new file mode 100644
index 00000000..cd786bae
--- /dev/null
+++ b/templates/man5/locatedb.5.pot
@@ -0,0 +1,324 @@
+# SOME DESCRIPTIVE TITLE
+# Copyright (C) YEAR Free Software Foundation, Inc.
+# This file is distributed under the same license as the PACKAGE package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"POT-Creation-Date: 2023-06-27 19:35+0200\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"Language: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. type: TH
+#: debian-bookworm debian-unstable
+#, no-wrap
+msgid "LOCATEDB"
+msgstr ""
+
+#. type: SH
+#: debian-bookworm debian-unstable
+#, no-wrap
+msgid "NAME"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid "locatedb - front-compressed file name database"
+msgstr ""
+
+#. type: SH
+#: debian-bookworm debian-unstable
+#, no-wrap
+msgid "DESCRIPTION"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"This manual page documents the format of file name databases for the GNU "
+"version of B<locate>. The file name databases contain lists of files that "
+"were in particular directory trees when the databases were last updated."
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"There can be multiple databases. Users can select which databases B<locate> "
+"searches using an environment variable or command line option; see "
+"B<locate>(1). The system administrator can choose the file name of the "
+"default database, the frequency with which the databases are updated, and "
+"the directories for which they contain entries. Normally, file name "
+"databases are updated by running the B<updatedb> program periodically, "
+"typically nightly; see B<updatedb>(1)."
+msgstr ""
+
+#. type: SH
+#: debian-bookworm debian-unstable
+#, no-wrap
+msgid "GNU LOCATE02 database format"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"This is the default format of databases produced by B<updatedb>. The "
+"B<updatedb> program runs B<frcode> to compress the list of file names using "
+"front-compression, which reduces the database size by a factor of 4 to 5. "
+"Front-compression (also known as incremental encoding) works as follows."
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"The database entries are a sorted list (case-insensitively, for users' "
+"convenience). Since the list is sorted, each entry is likely to share a "
+"prefix (initial string) with the previous entry. Each database entry begins "
+"with an signed offset-differential count byte, which is the additional "
+"number of characters of prefix of the preceding entry to use beyond the "
+"number that the preceding entry is using of its predecessor. (The counts "
+"can be negative.) Following the count is a null-terminated ASCII remainder "
+"\\(em the part of the name that follows the shared prefix."
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"If the offset-differential count is larger than can be stored in a signed "
+"byte (\\(+-127), the byte has the value 0x80 (binary 10000000) and the "
+"actual count follows in a 2-byte word, with the high byte first (network "
+"byte order). This count can also be negative (the sign bit being in the "
+"first of the two bytes)."
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"Every database begins with a dummy entry for a file called `LOCATE02', which "
+"B<locate> checks for to ensure that the database file has the correct "
+"format; it ignores the entry in doing the search."
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"Databases cannot be concatenated together, even if the first (dummy) entry "
+"is trimmed from all but the first database. This is because the offset-"
+"differential count in the first entry of the second and following databases "
+"will be wrong."
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"In the future, the data within the locate database may not be sorted in any "
+"particular order. To obtain sorted results, pipe the output of B<locate> "
+"through B<sort -f>."
+msgstr ""
+
+#. type: SH
+#: debian-bookworm debian-unstable
+#, no-wrap
+msgid "slocate database format"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"The B<slocate> program uses a database format similar to, but not quite the "
+"same as, GNU B<locate>. The first byte of the database specifies its "
+"I<security> I<level>. If the security level is 0, B<slocate> will read, "
+"match and print filenames on the basis of the information in the database "
+"only. However, if the security level byte is 1, B<slocate> omits entries "
+"from its output if the invoking user is unable to access them. The second "
+"byte of the database is zero. The second byte is followed by the first "
+"database entry. The first entry in the database is not preceded by any "
+"differential count or dummy entry. Instead the differential count for the "
+"first item is assumed to be zero."
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"Starting with the second entry (if any) in the database, data is interpreted "
+"as for the GNU LOCATE02 format."
+msgstr ""
+
+#. type: SH
+#: debian-bookworm debian-unstable
+#, no-wrap
+msgid "Old Locate Database format"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"There is also an old database format, used by Unix B<locate> and B<find> "
+"programs and earlier releases of the GNU ones. B<updatedb> runs programs "
+"called B<bigram> and B<code> to produce old-format databases. The old "
+"format differs from the above description in the following ways. Instead of "
+"each entry starting with an offset-differential count byte and ending with a "
+"null, byte values from 0 through 28 indicate offset-differential counts from "
+"-14 through 14. The byte value indicating that a long offset-differential "
+"count follows is 0x1e (30), not 0x80. The long counts are stored in host "
+"byte order, which is not necessarily network byte order, and host integer "
+"word size, which is usually 4 bytes. They also represent a count 14 less "
+"than their value. The database lines have no termination byte; the start of "
+"the next line is indicated by its first byte having a value \\(E<lt>= 30."
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"In addition, instead of starting with a dummy entry, the old database format "
+"starts with a 256 byte table containing the 128 most common bigrams in the "
+"file list. A bigram is a pair of adjacent bytes. Bytes in the database "
+"that have the high bit set are indexes (with the high bit cleared) into the "
+"bigram table. The bigram and offset-differential count coding makes these "
+"databases 20\\(en25% smaller than the new format, but makes them not 8-bit "
+"clean. Any byte in a file name that is in the ranges used for the special "
+"codes is replaced in the database by a question mark, which not "
+"coincidentally is the shell wildcard to match a single character."
+msgstr ""
+
+#. type: SH
+#: debian-bookworm debian-unstable
+#, no-wrap
+msgid "EXAMPLE"
+msgstr ""
+
+#. with nulls changed to newlines:
+#. type: Plain text
+#: debian-bookworm debian-unstable
+#, no-wrap
+msgid ""
+"Input to B<frcode>:\n"
+"/usr/src\n"
+"/usr/src/cmd/aardvark.c\n"
+"/usr/src/cmd/armadillo.c\n"
+"/usr/tmp/zoo\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+#, no-wrap
+msgid ""
+"Length of the longest prefix of the preceding entry to share:\n"
+"0 /usr/src\n"
+"8 /cmd/aardvark.c\n"
+"14 rmadillo.c\n"
+"5 tmp/zoo\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"Output from B<frcode>, with trailing nulls changed to newlines and count "
+"bytes made printable:"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+#, no-wrap
+msgid ""
+"0 LOCATE02\n"
+"0 /usr/src\n"
+"8 /cmd/aardvark.c\n"
+"6 rmadillo.c\n"
+"-9 tmp/zoo\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+#, no-wrap
+msgid "(6 = 14 - 8, and -9 = 5 - 14)\n"
+msgstr ""
+
+#. type: SH
+#: debian-bookworm debian-unstable
+#, no-wrap
+msgid "REPORTING BUGS"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"GNU findutils online help: E<lt>https://www.gnu.org/software/findutils/#get-"
+"helpE<gt>"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"Report any translation bugs to E<lt>https://translationproject.org/team/E<gt>"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid "Report any other issue via the form at the GNU Savannah bug tracker:"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid "E<lt>https://savannah.gnu.org/bugs/?group=findutilsE<gt>"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"General topics about the GNU findutils package are discussed at the I<bug-"
+"findutils> mailing list:"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid "E<lt>https://lists.gnu.org/mailman/listinfo/bug-findutilsE<gt>"
+msgstr ""
+
+#. type: SH
+#: debian-bookworm debian-unstable
+#, no-wrap
+msgid "COPYRIGHT"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"Copyright \\(co 1994-2022 Free Software Foundation, Inc. License GPLv3+: "
+"GNU GPL version 3 or later E<lt>https://gnu.org/licenses/gpl.htmlE<gt>."
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"This is free software: you are free to change and redistribute it. There is "
+"NO WARRANTY, to the extent permitted by law."
+msgstr ""
+
+#. type: SH
+#: debian-bookworm debian-unstable
+#, no-wrap
+msgid "SEE ALSO"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid "B<find>(1), B<locate>(1), B<xargs>(1), B<locatedb>(5)"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"Full documentation E<lt>https://www.gnu.org/software/findutils/locatedbE<gt>"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid "or available locally via: B<info locatedb>"
+msgstr ""