DTLOCATOR(4)

📦
version 2.5.3 · 2 versions
, in nixos 26.05

🌸 NAME 🌸

okay so bestie, welcome to DTLOCATOR(4) — the manual page for Generalized Locator Format, special file edition — and its whole mission is to address infolibs as document collections with external navigation references. That's the name, that's the assignment, and yes it is giving “locator string but make it fashion.” 💅✨

🎀 SYNOPSIS 🎀

The grammar is literally right here, preserved exactly, no edits, no “fixing” the punctuation:

       &<GLF> ::= &<MMDB> | &<ULV> | &<URI>

       &<MMDB> ::= mmdb:  &<IBL> | &<IB> | &<IL> | &<INFOLIB> | &<BL> | &<BOOKCASE> |
                  &<LOCATOR>

       &<IBL> ::= &<INFOLIB> & &<BOOKCASE> & &<LOCATOR>

       &<IB> ::= &<INFOLIB> & &<BOOKCASE>

       &<IL> ::= &<INFOLIB> & &<LOCATOR>

       &<BL> ::= &<BOOKCASE> & &<LOCATOR>

       &<INFOLIB> ::= INFOLIB= &<NAME>

       &<BOOKCASE> ::= BOOKCASE= &<NAME>

       &<LOCATOR> ::= LOCATOR= &<ULV> &<NAME>

       &<ULV> ::= uuid_ | xsm_ | isbn_

       &<NAME> ::= &<CHAR> { &<CHAR> )

       &<CHAR> ::= a-z | A-Z | 0-9 | &<SPECIAL_CHAR>

       &<SPECIAL_CHAR> ::= everything but ":" and "&"

       &<URI> ::= Uniform Resource Identifier (as defined by the Web Consortium)

💖 DESCRIPTION 💖

okay, so picture this: for the purpose of addressing infolibs as document collections with external navigation references, a generalized locator format is defined for use in applications and by the end-user. 🫶

This mechanism is more precise than those that operate on the DtInfoLib level. Not just a vibe — actual precision. 👑

This mechanism can be used by applications that want to tightly integrate to their on-line documentation, within the action system, or for printing specific sections from a command line. All three are in the mix, bestie: tightly integrate to their on-line documentation, within the action system, or for printing specific sections from a command line. 🔥

The syntax of a generalized locator format string is defined above. Yes, queen — scroll up to SYNOPSIS, the grammar block is right there. ✨

As shown above, there are several reserved terms that are used to identify locator format, including:

  • uuid — for DCE style Unique ID
  • xsm — for XSession Manager style Unique ID
  • ISBN — for International Standard Book Number

Of these only xsm is supported directly in the sample implementation. That's the whole caveat — only xsm, directly, in the sample implementation. No extra lore, no extra claims. 💀

That's the tea 🍓: Generalized Locator Format, manual section 4, special file. The source/version/date footer didn't actually show up in the page I was given, so no cap — I'm not inventing version/date lore. Mwah 💋

📦 where this page comes from