dot

packages and services management
Log | Files | Refs | README

commit 8f44f4c922d93db434c97746c82ea6949fedd400
parent f46361e88e7d56a1ce5ff8e7122a1394ec77c8f9
Author: Josuah Demangeon⠠⠵ <mail@josuah.net>
Date:   Tue,  4 Apr 2017 21:49:58 +0200

added a fake quine to produce mandoc output

Diffstat:
Mman/README | 319++++++++++++++++++++++++++++++++++++++++---------------------------------------
1 file changed, 160 insertions(+), 159 deletions(-)

diff --git a/man/README b/man/README @@ -1,244 +1,245 @@ -printf '%s\n\n%s\n' "$(head -n 2 "$0")" "$(mandoc *.1 | sed 's/.\b//g')" > "$0" +printf '%s\n\n\n%s\n' "$(head -n 2 "$0")" "$(mandoc *.1 | sed 's/.//g')" > "$0" exit 0 -BUIL) GeneraCommandManua BUIL) -NAM - buil –Instalsourcefrobuilreceipe +BUILD(1) General Commands Manual BUILD(1) -SYNOPSI - buil [-pk] [-pk] [-pk] [-pk] [-] [-] +NAME + build – Install sources from build receipes -DESCRIPTIO - builhelpwitthcompilatioosoftwarithhomdirectoroa - use. IdownloadaarchivfrospecifieURanextracti. +SYNOPSIS + build [-d pkg] [-i pkg] [-r pkg] [-u pkg] [-l] [-v] - -pk Downloaanextracthsourcopk. +DESCRIPTION + build helps with the compilation of software in the home directory of an + user. It downloads an archive from a specified URL and extracts it. - -pk Downloapkinopresen,buili,aninstali. + -d pkg Download and extract the source of pkg. - -pk Removpkanitsource. + -i pkg Download pkg if not present, build it, and install it. - -pk Delet,thedownloaaninstalpkagai. + -r pkg Remove pkg and its sources. - - UpdatlinkfroPROGRAMtLOCA. + -u pkg Delete, then download and install pkg again. - - Viethlisoavailablpackage. + -l Update links from PROGRAMS to LOCAL. -ENVIRONMEN - Everprograiinstalleiitowdirector,theeverfili - linketglobainde. ThPATanMANPAThavtbupdatetth - locatioothbianmasubdirectorieothiindeiordet - accesthbinarieanmanuapageinteractivel. + -v View the list of available packages. - Thicabdonbsourcinbuilaregulashelscrip,witth - comman: +ENVIRONMENT + Every program is installed in its own directory, then every file is + linked to a global index. The PATH and MANPATH have to be updated to the + location of the bin and man subdirectories of this index in order to + access the binaries and manual pages interactively. - .pattbuil + This can be done by sourcing build as a regular shell script, with the + command: - Thiwilexporthfollowinenvironmenvariable: + . path/to/build - Nam Defaulvalu - LOCA HOMEloca - CONFI HOMEconfi - PROGRAM HOMEprogram - PAT LOCALsbinLOCALbinPAT - MANPAT LOCALsharemanLOCALmanMANPAT - CPAT LOCALincludeCPAT - LIBPAT LOCALlibLIBPAT - LD_RUN_PAT LOCALlibLD_RUN_PAT - LD_LIBRARY_PAT LOCALlibLD_LIBRARY_PAT + This will export the following environment variables: -FILE - Thpackagedescription,URL,anbuilrulearstoreintfile, - storeintthCONFIGbuildirector,witonfilpepackag. + Name Default value + LOCAL $HOME/.local + CONFIG $HOME/.config + PROGRAMS $HOME/programs + PATH $LOCAL/sbin:$LOCAL/bin:$PATH + MANPATH $LOCAL/share/man:$LOCAL/man:$MANPATH + CPATH $LOCAL/include:$CPATH + LIBPATH $LOCAL/lib:$LIBPATH + LD_RUN_PATH $LOCAL/lib:$LD_RUN_PATH + LD_LIBRARY_PATH $LOCAL/lib:$LD_LIBRARY_PATH - Thesarshelscriptsourcebbuil ,antheiformaia - followin: +FILES + The packages descriptions, URLs, and build rules are stored into files, + stored into the $CONFIG/build directory, with one file per package. - #singllindescriptio nsheban) + These are shell scripts sourced by build , and their format is as + following: - tahtt:/urtpackagtag + # single line description (no shebang) - buil() { - #Optionnabuilrecip + tar=http://url.to/package.tar.gz + + build() { + # Optionnal build recipe } - Thbuilrecipioptionna,aniiinoprovide,defaulbuil - recipwilbuseinstea. + The build recipe is optionnal, and if it is not provided, a default build + recipe will be used instead. -AUTHO - builiwrittebJosuaDemangeo mailjosuahne> +AUTHOR + build is written by Josuah Demangeon <mail@josuah.net> -Linu1ARC Marc,201 Linu1ARC +Linux 4.9.11-1-ARCH March 4, 2017 Linux 4.9.11-1-ARCH ------------------------------------------------------------------------------ -VERSIO) GeneraCommandManua VERSIO) +VERSION(1) General Commands Manual VERSION(1) -NAM - versio –simplversiocontroanbackusyste +NAME + version – simple version control and backup system -SYNOPSI - versio [-] [-] [-revrev] [-re] [-fil.tre] +SYNOPSIS + version [-i] [-n] [-d rev1 rev2] [-r rev] [-p file ... tree] -DESCRIPTIO - Versiostorethwholcontenodirectortreaversio - controlle,hasheobject. +DESCRIPTION + Version stores the whole content of a directory tree as version + controlled, hashed objects. - Thipermitbackuanrestorinthcontenaanpoinith - histor,aneverfilionlbackeuoncialanacrosal - version. + This permits backup and restoring the content at any point in the + history, and every file is only backed up once in all and across all + versions. - Thfilearalcopieintthfirsleveodirector,renamet - theiowSH25has. Thesfilearobject. + The files are all copied into the first level of a directory, renamed to + their own SHA-256 hash. These files are objects. - Thmatchinbetweethesfileantheioriginalocatioials - storetsavthoriginanamothfile. Thfilestorinthi - informatioarrevision. + The matching between these files and their original location is also + stored to save the original name of the files. The files storing this + information are revisions. - -revrev - Difthchangefrorevtrev. + -d rev1 rev2 + Diff the changes from rev1 to rev2. - - Initializneversiodirectorathrooocurren - director. + -i Initialize a new version directory at the root of current + directory. - - Nerevisioicreate,savinalmodificationforthlas - saverevisio. + -n New revision is created, saving all modifications form the last + saved revision. - -fil.tre - Pulthobjectfrothfil.treversiodirectorint - thcurrenon. + -p file ... tree + Pull the objects from the file ... tree version directory into + the current one. - -re Reverthchangetanswitcthstattre. + -r rev Revert the changes to and switch the state to rev. -FILE -  Maiversiodirector. Thdirectoriwhicilocatei - throoversiodirector. +FILES + .v Main version directory. The directory in which .v is located is + the root version directory. - vobj/ - Directorcontaininthobjectevernameaftethhaso - itconten. + .v/obj/ + Directory containing the objects every named after the hash of + its content. - vrev/ - Directorcontaininthrevisionwhiccontainthliso - file,alonwittheiassociatehashe,ithfollowin - forma: + .v/rev/ + Directory containing the revisions which contains the list of + files, along with their associated hashes, in the following + format: - 6a2e5ffc2916c10ce723c6866f2680086cef2a1ef0d052b471787adab568bdd .pattfiltx + 6a2e5ffc2916c10ce723c6866f2680086cef2a1ef0d052b471787adab568bddd ./path/to/file.txt - Threvisionaralsnameaftetheiconten. + The revisions are also named after their content. - vlo filcontaininahistoroeverrevisioalisonam - orevisiofile,witonrevisiopelin. + .v/log A file containing an history of every revision as a list of name + of revision files, with one revision per line. -EXAMPL - Initializneversiodirectoriexistindirector +EXAMPLE + Initialize a new version directory in existing directory - $cdat/ - $versio + $ cd data/ + $ version -i - Creatnerevisio: + Create a new revision: - $versio - makinnerevisio - ba49aa8aabb111af9d3837e4fc1a2c4edf91fb092f9093d09a6d7c5fc15e388 - $touctes - $versio - makinnerevisio - ba49aa8aabb111af9d3837e4fc1a2c4edf91fb092f9093d09a6d7c5fc15e388 - 9e59e557dad5b2c8b66313a2836afd1970990b885d08e728e6cd5a2a7b7df58 + $ version -n + making a new revision + ba49aa8aabb111af9d3837e4fc1a2c4edf91fb092f9093d09a6d7c5fc15e3888 + $ touch test + $ version -n + making a new revision + ba49aa8aabb111af9d3837e4fc1a2c4edf91fb092f9093d09a6d7c5fc15e3888 + 9e59e557dad5b2c8b66313a2836afd1970990b885d08e728e6cd5a2a7b7df584 - Diffinlastwrevision: + Diffing last two revisions: - $versio $tai lo) + $ version -d $(tail -n 2 .v/log) ... - Finthrevisiocorrespondintfil: + Find the revision corresponding to a file: - $gre rlpattfiltx re/ - re9e59e557dad5b2c8b66313a2836afd1970990b885d08e728e6cd5a2a7b7df58 + $ grep -rlF path/to/file.txt .v/rev/ + .v/rev/9e59e557dad5b2c8b66313a2836afd1970990b885d08e728e6cd5a2a7b7df584 -Linu1ARC Apri,201 Linu1ARC +Linux 4.9.11-1-ARCH April 4, 2017 Linux 4.9.11-1-ARCH ------------------------------------------------------------------------------ -WWGI LOCA WWGI +WWW-GIT LOCAL WWW-GIT -NAM - ww-gi –generatstatiwebsitwitthgicomman +NAME + www-git – generate static website with the git command -SYNOPSI - ww-gi +SYNOPSIS + www-git -DESCRIPTIO - ww-giwilcreatgisubdirectoricurrendirectorwiton - subdirectorpegirepositor. Repositoriearspecifiefroth - descriptiofil. +DESCRIPTION + www-git will create a git subdirectory in current directory with one + subdirectory per git repository. Repositories are specified from the + description file. -Linu1ARC Marc2,201 Linu1ARC +Linux 4.9.11-1-ARCH March 23, 2017 Linux 4.9.11-1-ARCH ------------------------------------------------------------------------------ -WWTRE) GeneraCommandManua WWTRE) +WWW-TREE(1) General Commands Manual WWW-TREE(1) -NAM - ww-tre –simpl,recursivstatiwebsitgenerato +NAME + www-tree – simple, recursive static website generator -SYNOPSI - cpat &&ww +SYNOPSIS + cd path && www -DESCRIPTIO - Thonlthinthiscripdoeibuildinonindehtmfoeac - director,includinDIitsel. +DESCRIPTION + The only thing this script does is building one index.html for each + directory, including DIR itself. - Eacindehtmhathcontenolayouthtmfilithtopat - director,aftebeinparse. + Each index.html has the content of a layout.html file in the top path + directory, after being parsed. -FILE - Somfileartreateparticularl. +FILES + Some files are treated particularly. - dilayouhtm - Filcontaininthindehtmpagelayou. + dir/layout.html + File containing the index.html pages layout. - di/*READM - Th READM"filecontencabdisplayeothpageith - layoucontain {{conten }}keywor. + dir/*/README + The "README" files content can be displayed on the pages if the + layout contains a {{ content }} keyword. - di/.* Aldirectoriestartinwit ‘.’wilbignore. + dir/.* All directories starting with a ‘.’ will be ignored. - Alothedirectoriearignoreanleunchange. + All other directories are ignored and let unchanged. -LAYOUFORMA - Withilayouhtm,somtemplatinpermitinserdynamiconten - intthindefile,businthfollowinkeyword. +LAYOUT FORMAT + Within a layout.html, some templating permit to insert dynamic content + into the index files, by using the following keywords. - {{conten }} - ContenothREADMfilithcurrendirector,ian. + {{ content }} + Content of the README file in the current directory, if any. - {{lis }} - Lisolinktsubpagefothcurrendirector includin - dotfile). + {{ list }} + List of links to subpages for the current directory (including + dotfiles). - {{na }} - Lisotolevedirectorie,fousa na>elemen. + {{ nav }} + List of top level directories, for use as a <nav> element. - {{roo }} - Relativpattthrooothwebsit,forelativlink. + {{ root }} + Relative path to the root of the website, for relative links. - {{titl }} - Pagtitl,givebthpat,wit "/"replaceb " > ". + {{ title }} + Page title, given by the path, with "/" replaced by " > ". -ENVIRONMEN - PW Sourcdirectorfrowhicgeneratthwebsit. Iials - wherthwebsitwilbgenerate. +ENVIRONMENT + PWD Source directory from which generate the website. It is also + where the website will be generated. -SEALS - httpmarmarodthwebsitthagavmthide. +SEE ALSO + http://marmaro.de the website that gave me the idea. - wer)swer) + werc(1) swerc(1) -AUTHOR - wwimadbJosuaDemangeo maijosuane⟩ +AUTHORS + www is made by Josuah Demangeon ⟨mail@josuah.net⟩ -Linu1ARC Novembe1,201 Linu1ARC +Linux 4.9.11-1-ARCH November 11, 2016 Linux 4.9.11-1-ARCH