diff --git a/docs/man/equo.pod b/docs/man/equo.pod index 2b8310d2f..43809191a 100644 --- a/docs/man/equo.pod +++ b/docs/man/equo.pod @@ -1,3 +1,4 @@ + =head1 NAME B - Official Sabayon Linux Package Manager Client @@ -34,1372 +35,1465 @@ Content produced by other users. =over -=item B<--help (-h)> +=item [1] B<--help> this output -=item B<--version> +=item [1] B<--version> print version -=item B<--nocolor> +=item [1] B<--nocolor> disable colorized output +=item [1] B<--bashcomp> + +print a bash completion script to stdout + + =back =head1 OPTIONS =over -=item B +=item [1] B update configured repositories + =over -=item B<--force> +=item [2] B<--force> force sync regardless repositories status + =back -=item B +=item [1] B manage your repositories + =over -=item B +=item [2] B enable given repository -=item B +=item [2] B disable given repository -=item B> +=item [2] BstringE> add repository (pass repository string) -=item B> +=item [2] BidE> remove repository -=item B> +=item [2] BidE> reorder mirrors basing on response time -=item B> +=item [2] BdestE> merge content of source repos to dest [for developers] + =over -=item B<--conflicts> +=item [3] B<--conflicts> also remove dependency conflicts during merge -=back =back -=item B + +=back + +=item [1] B repository notice board reader -=item B +=item [1] B show respositories status -=item B +=item [1] B search packages in repositories -=item B +=item [1] B match a package in repositories + =over -=item B<--multimatch> +=item [2] B<--multimatch> return all the possible matches -=item B<--installed> +=item [2] B<--installed> match inside installed packages repository -=item B<--multirepo> +=item [2] B<--multirepo> return matches from every repository -=item B<--showrepo> +=item [2] B<--showrepo> print repository information (w/--quiet) -=item B<--showdesc> +=item [2] B<--showdesc> print description too (w/--quiet) + =back -=item B> +=item [1] BbranchE> upgrade your distribution to a new release (branch) -=item B +=item [1] B update system with the latest available packages + =over -=item B<--ask (-a)> +=item [2] B<--ask> ask before making any changes -=item B<--fetch> +=item [2] B<--fetch> just download packages -=item B<--pretend (-p)> +=item [2] B<--pretend> only show what would be done -=item B<--verbose (-v)> +=item [2] B<--verbose> show more details about what is going on -=item B<--replay> +=item [2] B<--replay> reinstall all the packages and their dependencies -=item B<--empty> +=item [2] B<--empty> same as --replay -=item B<--resume> +=item [2] B<--resume> resume previously interrupted operations -=item B<--skipfirst> +=item [2] B<--skipfirst> used with --resume, makes the first package to be skipped -=item B<--multifetch> +=item [2] B<--multifetch> download multiple packages in parallel (default 3) -=item B<--multifetch=N> +=item [2] B<--multifetch=N> download N packages in parallel (max 10) + =back -=item B +=item [1] B security infrastructure functions + =over -=item B +=item [2] B verify installed files using stored checksums + =over -=item B<--mtime> +=item [3] B<--mtime> consider mtime instead of SHA256 (false positives ahead) -=back - -=item B<--assimilate> +=item [3] B<--assimilate> update hashes and mtime (useful after editing config files) -=back - -=item B<--quiet> - -show less details (useful for scripting) - -=back - -=item B<--verbose> - -also list removed files - -=back - -=over - -=item B<--reinstall> +=item [3] B<--reinstall> reinstall faulty packages +=item [3] B<--quiet> + +show less details (useful for scripting) + +=item [3] B<--verbose> + +also list removed files + + =back -=item B +=item [2] B download the latest Security Advisories + =over -=item B<--force> +=item [3] B<--force> force download even if already up-to-date + =back -=item B +=item [2] B list all the available Security Advisories -=item B<--affected> + +=over + +=item [3] B<--affected> list only affected -=item B<--unaffected> +=item [3] B<--unaffected> list only unaffected -=item B + +=back + +=item [2] B show information about provided advisories identifiers -=item B +=item [2] B automatically install all the available security updates -=item B<--ask (-a)> + +=over + +=item [3] B<--ask> ask before making any changes -=item B<--fetch> +=item [3] B<--fetch> just download packages -=item B<--pretend (-p)> +=item [3] B<--pretend> just show what would be done -=item B<--quiet (-q)> +=item [3] B<--quiet> show less details (useful for scripting) + =back -=item B + +=back + +=item [1] B install atoms or binary packages + =over -=item B<--ask (-a)> +=item [2] B<--ask> ask before making any changes -=item B<--pretend (-p)> +=item [2] B<--pretend> just show what would be done -=item B<--fetch> +=item [2] B<--fetch> just download packages without doing the install -=item B<--nodeps> +=item [2] B<--nodeps> do not pull in any dependency -=item B<--bdeps> +=item [2] B<--bdeps> also pull in build-time dependencies -=item B<--resume> +=item [2] B<--resume> resume previously interrupted operations -=item B<--skipfirst> +=item [2] B<--skipfirst> used with --resume, makes the first package in queue to be skipped -=item B<--clean> +=item [2] B<--clean> remove downloaded packages after being used -=item B<--empty> +=item [2] B<--empty> pull all the dependencies in, regardless their state -=item B<--relaxed> +=item [2] B<--relaxed> calm down dependencies resolution algorithm (might be risky) -=item B<--deep> +=item [2] B<--deep> makes dependency rules stricter -=item B<--verbose (-v)> +=item [2] B<--verbose> show more details about what is going on -=item B<--configfiles> +=item [2] B<--configfiles> makes old configuration files to be removed -=item B<--multifetch> +=item [2] B<--multifetch> download multiple packages in parallel (default 3) -=item B<--multifetch=N> +=item [2] B<--multifetch=N> download N packages in parallel (max 10) + =back -=item B +=item [1] B download atoms source code + =over -=item B<--ask (-a)> +=item [2] B<--ask> ask before making any changes -=item B<--pretend (-p)> +=item [2] B<--pretend> just show what would be done -=item B<--nodeps> +=item [2] B<--nodeps> do not pull in any dependency -=item B<--relaxed> +=item [2] B<--relaxed> calm down dependencies resolution algorithm (might be risky) -=item B<--savehere> +=item [2] B<--savehere> save sources in current working directory + =back -=item B +=item [1] B just download packages without doing the install + =over -=item B<--ask (-a)> +=item [2] B<--ask> ask before making any changes -=item B<--pretend (-p)> +=item [2] B<--pretend> just show what would be done -=item B<--nodeps> +=item [2] B<--nodeps> do not pull in any dependency -=item B<--relaxed> +=item [2] B<--relaxed> calm down dependencies resolution algorithm (might be risky) -=item B<--multifetch> +=item [2] B<--multifetch> download multiple packages in parallel (default 3) -=item B<--multifetch=N> +=item [2] B<--multifetch=N> download N packages in parallel (max 10) + =back -=item B +=item [1] B remove one or more packages + =over -=item B<--ask (-a)> +=item [2] B<--ask> ask before making any changes -=item B<--pretend (-p)> +=item [2] B<--pretend> just show what would be done -=item B<--nodeps> +=item [2] B<--nodeps> do not pull in any dependency -=item B<--deep> +=item [2] B<--deep> also pull unused dependencies where reverse deps list is empty -=item B<--empty> +=item [2] B<--empty> when used with --deep, helps the removal of virtual packages -=item B<--configfiles> +=item [2] B<--configfiles> makes configuration files to be removed -=item B<--force-system> +=item [2] B<--force-system> -dangerous: forces system packages removal, do not use this +dangerous: forces system packages removal, do not use this! -=item B<--resume> +=item [2] B<--resume> resume previously interrupted operations + =back -=item B +=item [1] B mask one or more packages + =over -=item B<--ask (-a)> +=item [2] B<--ask> ask before making any changes -=item B<--pretend (-p)> +=item [2] B<--pretend> just show what would be done + =back -=item B +=item [1] B unmask one or more packages + =over -=item B<--ask (-a)> +=item [2] B<--ask> ask before making any changes -=item B<--pretend (-p)> +=item [2] B<--pretend> just show what would be done + =back -=item B +=item [1] B configure one or more installed packages + =over -=item B<--ask (-a)> +=item [2] B<--ask> ask before making any changes -=item B<--pretend (-p)> +=item [2] B<--pretend> just show what would be done -=item B + +=back + +=item [1] B look for unsatisfied dependencies -=item B<--quiet (-q)> + +=over + +=item [2] B<--quiet> show less details (useful for scripting) -=item B<--ask (-a)> +=item [2] B<--ask> ask before making any changes -=item B<--pretend (-p)> +=item [2] B<--pretend> just show what would be done + =back -=item B +=item [1] B look for unused packages (pay attention) + =over -=item B<--quiet (-q)> +=item [2] B<--quiet> show less details (useful for scripting) -=item B<--sortbysize> +=item [2] B<--sortbysize> sort packages by disk size + =back -=item B +=item [1] B look for missing libraries + =over -=item B<--dump> +=item [2] B<--dump> dump results to files -=item B<--listfiles> +=item [2] B<--listfiles> print broken files to stdout -=item B<--quiet (-q)> +=item [2] B<--quiet> show less details (useful for scripting) -=item B<--ask (-a)> +=item [2] B<--ask> ask before making any changes -=item B<--pretend (-p)> +=item [2] B<--pretend> just show what would be done + =back -=item B +=item [1] B configuration files update tool + =over -=item B +=item [2] B show configuration files to be updated -=item B +=item [2] B run the configuration files update function + =back -=item B +=item [1] B do misc queries on repository and local databases + =over -=item B +=item [2] B search from what package a file belongs -=item B +=item [2] B show packages changelog -=item B +=item [2] B search what packages depend on the provided atoms -=item B +=item [2] B search packages by description -=item B +=item [2] B show files owned by the provided atoms -=item B +=item [2] B search a package into the local database -=item B +=item [2] B show packages owning the provided licenses -=item B +=item [2] B list packages based on the chosen parameter below + =over -=item B +=item [3] B list installed packages +=item [3] B + +list available packages + + =back -=item B +=item [2] B search packages able to handle given mimetypes + =over -=item B<--installed> +=item [3] B<--installed> + +search among installed packages -search inside installed packages =back -=item B +=item [2] B associate given file paths to applications able to read them + =over -=item B<--installed> +=item [3] B<--installed> + +search among installed packages -search inside installed packages =back -=item B +=item [2] B show runtime libraries needed by the provided atoms -=item B +=item [2] B search files that do not belong to any package -=item B +=item [2] B show the removal tree for the specified atoms -=item B +=item [2] B show atoms needing the provided libraries -=item B +=item [2] B search available package sets -=item B +=item [2] B show packages owning the provided slot -=item B +=item [2] B -show packages owning the specified tags +show packages owning the provided tags -=item B - -show installed packages owning the specified revisions - -=item B +=item [2] B show direct depdendencies tree for provided installable atoms + =over -=item B<--complete> +=item [3] B<--complete> include system packages, build deps and circularity information + =back -=item B +=item [2] B show reverse depdendencies tree for provided installed atoms + =over -=item B<--complete> +=item [3] B<--complete> include system packages, build deps and circularity information + =back -=item B<--verbose (-v)> +=item [2] B<--verbose> show more details -=item B<--quiet (-q)> +=item [2] B<--quiet> print results in a scriptable way + =back + =back =head1 EXTENDED_OPTIONS =over - -=item B +=item [1] B handles extended functionalities + =over - -=item B +=item [2] B make a smart application for the provided atoms (experimental) - -=item B +=item [2] B make a smart package for the provided atoms (multiple packages into one file) -=item B +=item [2] B recreate an Entropy package from your System + =over - -=item B<--savedir> +=item [3] B<--savedir> save new packages into the specified directory + =back - -=item B +=item [2] B convert provided Source Package Manager package files into Entropy packages + =over - -=item B<--savedir> +=item [3] B<--savedir> save new packages into the specified directory + =back - -=item B +=item [2] B convert provided Entropy packages into Source Package Manager ones + =over - -=item B<--savedir> +=item [3] B<--savedir> save new packages into the specified directory + =back - -=item B +=item [2] B extract Entropy metadata from provided Entropy package files + =over - -=item B<--savedir> +=item [3] B<--savedir> save new metadata into the specified directory -=back =back -=item B +=back + +=item [1] B contains System rescue tools + =over - -=item B +=item [2] B check installed packages repository for errors -=item B +=item [2] B remove installed packages repository internal indexes to save disk space -=item B +=item [2] B generate installed packages database using Source Package Manager repositories -=item B +=item [2] B generate installed packages database using files on the system [last hope] -=item B +=item [2] B -regenerate SPM UIDs map (SPM <-> Entropy packages) +regenerate SPM UIDs map (SPM E-E Entropy packages) -=item B +=item [2] B makes Entropy aware of your Source Package Manager updated packages -=item B +=item [2] B backup the current Entropy installed packages database -=item B +=item [2] B restore a previously backed up Entropy installed packages database + =back - -=item B +=item [1] B handles community-side features + =over - -=item B +=item [2] B community repositories management functions + =over - -=item B +=item [3] B scan the System looking for newly compiled packages + =over - -=item B<--seekstore> +=item [4] B<--seekstore> analyze the Entropy Store directory directly -=item B<--repackage > +=item [4] B<--repackage EatomsE> repackage the specified atoms -=item B<--noask> +=item [4] B<--noask> do not ask anything except critical things -=item B<--atoms > +=item [4] B<--atoms EatomsE> manage only the specified atoms -=item B<--interactive> +=item [4] B<--interactive> run in interactive mode (asking things one by one) + =back - -=item B> +=item [3] BpackagesE> add binary packages to repository w/o affecting scopes (multipackages) + =back - -=item B +=item [2] B community repositories mirrors management functions + =over - -=item B +=item [3] B sync packages, database and also do some tidy + =over - -=item B<--noask> +=item [4] B<--noask> do not ask anything except critical things -=item B<--syncall> +=item [4] B<--syncall> sync all the configured repositories + =back - -=item B +=item [3] B sync packages across primary mirrors + =over - -=item B<--ask> +=item [4] B<--ask> ask before making any changes -=item B<--pretend> +=item [4] B<--pretend> only show what would be done -=item B<--syncall> +=item [4] B<--syncall> sync all the configured repositories -=item B<--do-packages-check> +=item [4] B<--do-packages-check> also verify packages integrity + =back - -=item B +=item [3] B sync the current repository database across primary mirrors + =over - -=item B<--syncall> +=item [4] B<--syncall> sync all the configured repositories + =back - -=item B +=item [3] B lock the current repository database (server-side) -=item B +=item [3] B unlock the current repository database (server-side) -=item B +=item [3] B lock the current repository database (client-side) -=item B +=item [3] B unlock the current repository database (client-side) -=item B +=item [3] B show current lock status -=item B +=item [3] B remove binary packages not in repositories and expired -=item B +=item [3] B clean unavaiable packages from mirrors (similar to tidy, but more nazi) + =over - -=item B<--days=> +=item [4] B<--days=EdaysE> expiration days [default is: 0, dangerous!] + =back =back - -=item B +=item [2] B manage a repository + =over - -=item B<--initialize> +=item [3] B<--initialize> (re)initialize the current repository database + =over - -=item B<--empty> +=item [4] B<--empty> do not refill database using packages on mirrors +=item [4] B<--repo=ErepoE> -=item B +(re)create the database for the specified repository + + +=back + +=item [3] B manually force a revision bump for the current repository database + =over - -=item B<--sync> +=item [4] B<--sync> synchronize the database + =back +=item [3] B -=item B +flush back old branches packages to current branch + +=item [3] B remove the provided atoms from the current repository database - -=item B +=item [3] B remove the provided injected atoms (all if no atom specified) -=over - - -=item B<--branch=> - -choose on what branch operating - -=back - - -=item B +=item [3] B create an empty repository database in the provided path -=item B > +=item [3] Bfrom branchE Eto branchE> switch to the specified branch the provided atoms (or world) -=item B +=item [3] B verify remote integrity of the provided atoms (or world) -=item B +=item [3] B backup current repository database -=item B +=item [3] B restore a previously backed-up repository database -=back +=item [3] B -=item B +regenerate SPM UIDs map (SPM E-E Entropy packages) -regenerate SPM UIDs map (SPM <-> Entropy packages) - -=item B> +=item [3] BrepoE> enable the specified repository -=item B> +=item [3] BrepoE> disable the specified repository -=item B> +=item [3] BrepoE> show the current Server Interface status -=item B [atoms]> +=item [3] BrepoE [atoms]> + +check packages in repository for missing dependencies + +=item [3] BrepoE [atoms]> handle packages dependencies -=item B [atoms]> +=item [3] BrepoE Etag-stringE [atoms]> clone a package inside a repository assigning it an arbitrary tag -=item B [atoms]> +=item [3] BfromE EtoE [atoms]> move packages from a repository to another -=item B [atoms]> + +=over + +=item [4] B<--deps> + +pulls dependencies in + + +=back + +=item [3] BfromE EtoE [atoms]> copy packages from a repository to another -=item B> + +=over + +=item [4] B<--deps> + +pulls dependencies in + + +=back + +=item [3] Brepo_idE> set the default repository + =back - -=item B +=item [2] B manage repository digital signatures (OpenGPG) + =over - -=item B +=item [3] B create keypair for repositories and sign packages -=item B +=item [3] B delete keypair (and digital signatures) of repository -=item B +=item [3] B show currently configured keys information for given repositories -=item B +=item [3] B sign (or re-sign) packages in repository using currently set keypair -=item B > +=item [3] Brepo_idE Eprivkey_pathE Epubkey_pathE> import keypair, bind to given repository -=item B > +=item [3] Brepo_idE Ekey_pathE> export public key of given repository -=back - -=item B > +=item [3] Brepo_idE Ekey_pathE> export private key of given repository + =back - -=item B +=item [2] B do some searches into community repository databases + =over - -=item B +=item [3] B show from what package the provided files belong -=item B +=item [3] B show packages changelog -=item B +=item [3] B show what packages depend on the provided atoms -=item B +=item [3] B search packages by description -=item B +=item [3] B show files owned by the provided atoms -=item B +=item [3] B list all the packages in the default repository -=item B +=item [3] B show runtime libraries needed by the provided atoms -=item B +=item [3] B search packages inside the default repository database -=item B +=item [3] B search available package sets -=item B +=item [3] B show packages owning the specified tags -=item B<--verbose> +=item [3] B + +show installed packages owning the specified revisions + +=item [3] B<--verbose> show more details -=item B<--quiet> +=item [3] B<--quiet> print results in a scriptable way + =back - -=item B +=item [2] B source package manager functions + =over - -=item B +=item [3] B compilation function + =over - -=item B +=item [4] B compile packages belonging to the provided categories + =over - -=item B<--list> +=item [5] B<--list> just list packages +=item [5] B<--nooldslots> + +do not pull old package slots + + =back - -=item B +=item [4] B compile packages in provided package set names + =over - -=item B<--list> +=item [5] B<--list> just list packages -=item B<--rebuild> +=item [5] B<--rebuild> rebuild everything -=item B<--dbupdate> +=item [5] B<--dbupdate> run database update if all went fine -=item B<--dbsync> +=item [5] B<--dbsync> run mirror sync if all went fine -=back =back -=item B +=back + +=item [3] B scan orphaned packages on SPM + =back - -=item B +=item [2] B notice board handling functions + =over - -=item B +=item [3] B add a news item to the notice board -=item B +=item [3] B remove a news item from the notice board -=item B +=item [3] B read the current notice board + =back - -=item B +=item [2] B look for unsatisfied dependencies across community repositories -=item B +=item [2] B verify the integrity of local package files -=item B +=back + +=item [1] B handles User Generated Content features + =over - -=item B> +=item [2] BrepositoryE> login against a specified repository -=item B> +=item [2] BrepositoryE> logout from a specified repository + =over - -=item B<--force> +=item [3] B<--force> force action + =back - -=item B> +=item [2] BrepositoryE> manage package documents for the selected repository (comments, files, videos) + =over - -=item B> +=item [3] BpkgkeyE> get available documents for the specified package key (example: x11-libs/qt) -=item B> +=item [3] BpkgkeyE> add a new document to the specified package key (example: x11-libs/qt) -=item B> +=item [3] Bdocs idsE> remove documents from database using their identifiers + =back - -=item B> +=item [2] BrepositoryE> manage package votes for the selected repository + =over - -=item B> +=item [3] BpkgkeyE> get vote for the specified package key (example: x11-libs/qt) -=item B> +=item [3] BpkgkeyE> add vote for the specified package key (example: x11-libs/qt) -=back =back -=item B +=back + +=item [1] B handles Entropy cache + =over - -=item B +=item [2] B clean Entropy cache -=item B<--verbose> +=item [2] B<--verbose> show more details -=item B<--quiet> +=item [2] B<--quiet> print results in a scriptable way + =back - -=item B +=item [1] B remove downloaded packages and clean temp. directories -=item B<--info> +=item [1] B<--info> show system information + =back =head1 ENVIRONMENT @@ -1441,4 +1535,4 @@ Fabio Erculiani =head1 SEE ALSO -reagent(1), activator(1) +reagent(1), activator(1) \ No newline at end of file diff --git a/docs/man/man1/equo.1 b/docs/man/man1/equo.1 index 5399f8dd5..bbf55da34 100644 --- a/docs/man/man1/equo.1 +++ b/docs/man/man1/equo.1 @@ -123,8 +123,8 @@ .rm #[ #] #H #V #F C .\" ======================================================================== .\" -.IX Title "EQUO 1" -.TH EQUO 1 "2011-02-07" "perl v5.12.2" "Entropy" +.IX Title "A 1" +.TH A 1 "2011-04-05" "perl v5.12.2" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -159,52 +159,55 @@ source code, sanity check your system, see and be part of the User Generated Content produced by other users. .SH "BASIC_OPTIONS" .IX Header "BASIC_OPTIONS" -.IP "\fB\-\-help (\-h)\fR" 4 -.IX Item "--help (-h)" +.IP "[1] \fB\-\-help\fR" 4 +.IX Item "[1] --help" this output -.IP "\fB\-\-version\fR" 4 -.IX Item "--version" +.IP "[1] \fB\-\-version\fR" 4 +.IX Item "[1] --version" print version -.IP "\fB\-\-nocolor\fR" 4 -.IX Item "--nocolor" +.IP "[1] \fB\-\-nocolor\fR" 4 +.IX Item "[1] --nocolor" disable colorized output +.IP "[1] \fB\-\-bashcomp\fR" 4 +.IX Item "[1] --bashcomp" +print a bash completion script to stdout .SH "OPTIONS" .IX Header "OPTIONS" -.IP "\fBupdate\fR" 4 -.IX Item "update" +.IP "[1] \fBupdate\fR" 4 +.IX Item "[1] update" update configured repositories .RS 4 -.IP "\fB\-\-force\fR" 4 -.IX Item "--force" +.IP "[2] \fB\-\-force\fR" 4 +.IX Item "[2] --force" force sync regardless repositories status .RE .RS 4 .RE -.IP "\fBrepo\fR" 4 -.IX Item "repo" +.IP "[1] \fBrepo\fR" 4 +.IX Item "[1] repo" manage your repositories .RS 4 -.IP "\fBenable\fR" 4 -.IX Item "enable" +.IP "[2] \fBenable\fR" 4 +.IX Item "[2] enable" enable given repository -.IP "\fBdisable\fR" 4 -.IX Item "disable" +.IP "[2] \fBdisable\fR" 4 +.IX Item "[2] disable" disable given repository -.IP "\fBadd " 4 -.IX Item "add " +.IP "[2] \fBadd \fR" 4 +.IX Item "[2] add " add repository (pass repository string) -.IP "\fBremove " 4 -.IX Item "remove " +.IP "[2] \fBremove \fR" 4 +.IX Item "[2] remove " remove repository -.IP "\fBmirrorsort " 4 -.IX Item "mirrorsort " +.IP "[2] \fBmirrorsort \fR" 4 +.IX Item "[2] mirrorsort " reorder mirrors basing on response time -.IP "\fBmerge [sources] " 4 -.IX Item "merge [sources] " +.IP "[2] \fBmerge [sources] \fR" 4 +.IX Item "[2] merge [sources] " merge content of source repos to dest [for developers] .RS 4 -.IP "\fB\-\-conflicts\fR" 4 -.IX Item "--conflicts" +.IP "[3] \fB\-\-conflicts\fR" 4 +.IX Item "[3] --conflicts" also remove dependency conflicts during merge .RE .RS 4 @@ -212,528 +215,540 @@ also remove dependency conflicts during merge .RE .RS 4 .RE -.IP "\fBnotice [repos]\fR" 4 -.IX Item "notice [repos]" +.IP "[1] \fBnotice [repos]\fR" 4 +.IX Item "[1] notice [repos]" repository notice board reader -.IP "\fBstatus\fR" 4 -.IX Item "status" +.IP "[1] \fBstatus\fR" 4 +.IX Item "[1] status" show respositories status -.IP "\fBsearch [atoms]\fR" 4 -.IX Item "search [atoms]" +.IP "[1] \fBsearch\fR" 4 +.IX Item "[1] search" search packages in repositories -.IP "\fBmatch [atoms]\fR" 4 -.IX Item "match [atoms]" +.IP "[1] \fBmatch\fR" 4 +.IX Item "[1] match" match a package in repositories .RS 4 -.IP "\fB\-\-multimatch\fR" 4 -.IX Item "--multimatch" +.IP "[2] \fB\-\-multimatch\fR" 4 +.IX Item "[2] --multimatch" return all the possible matches -.IP "\fB\-\-installed\fR" 4 -.IX Item "--installed" +.IP "[2] \fB\-\-installed\fR" 4 +.IX Item "[2] --installed" match inside installed packages repository -.IP "\fB\-\-multirepo\fR" 4 -.IX Item "--multirepo" +.IP "[2] \fB\-\-multirepo\fR" 4 +.IX Item "[2] --multirepo" return matches from every repository -.IP "\fB\-\-showrepo\fR" 4 -.IX Item "--showrepo" +.IP "[2] \fB\-\-showrepo\fR" 4 +.IX Item "[2] --showrepo" print repository information (w/\-\-quiet) -.IP "\fB\-\-showdesc\fR" 4 -.IX Item "--showdesc" +.IP "[2] \fB\-\-showdesc\fR" 4 +.IX Item "[2] --showdesc" print description too (w/\-\-quiet) .RE .RS 4 .RE -.IP "\fBhop " 4 -.IX Item "hop " +.IP "[1] \fBhop \fR" 4 +.IX Item "[1] hop " upgrade your distribution to a new release (branch) -.IP "\fBupgrade\fR" 4 -.IX Item "upgrade" +.IP "[1] \fBupgrade\fR" 4 +.IX Item "[1] upgrade" update system with the latest available packages .RS 4 -.IP "\fB\-\-ask (\-a)\fR" 4 -.IX Item "--ask (-a)" +.IP "[2] \fB\-\-ask\fR" 4 +.IX Item "[2] --ask" ask before making any changes -.IP "\fB\-\-fetch\fR" 4 -.IX Item "--fetch" +.IP "[2] \fB\-\-fetch\fR" 4 +.IX Item "[2] --fetch" just download packages -.IP "\fB\-\-pretend (\-p)\fR" 4 -.IX Item "--pretend (-p)" +.IP "[2] \fB\-\-pretend\fR" 4 +.IX Item "[2] --pretend" only show what would be done -.IP "\fB\-\-verbose (\-v)\fR" 4 -.IX Item "--verbose (-v)" +.IP "[2] \fB\-\-verbose\fR" 4 +.IX Item "[2] --verbose" show more details about what is going on -.IP "\fB\-\-replay\fR" 4 -.IX Item "--replay" +.IP "[2] \fB\-\-replay\fR" 4 +.IX Item "[2] --replay" reinstall all the packages and their dependencies -.IP "\fB\-\-empty\fR" 4 -.IX Item "--empty" +.IP "[2] \fB\-\-empty\fR" 4 +.IX Item "[2] --empty" same as \-\-replay -.IP "\fB\-\-resume\fR" 4 -.IX Item "--resume" +.IP "[2] \fB\-\-resume\fR" 4 +.IX Item "[2] --resume" resume previously interrupted operations -.IP "\fB\-\-skipfirst\fR" 4 -.IX Item "--skipfirst" +.IP "[2] \fB\-\-skipfirst\fR" 4 +.IX Item "[2] --skipfirst" used with \-\-resume, makes the first package to be skipped -.IP "\fB\-\-multifetch\fR" 4 -.IX Item "--multifetch" +.IP "[2] \fB\-\-multifetch\fR" 4 +.IX Item "[2] --multifetch" download multiple packages in parallel (default 3) -.IP "\fB\-\-multifetch=N\fR" 4 -.IX Item "--multifetch=N" +.IP "[2] \fB\-\-multifetch=N\fR" 4 +.IX Item "[2] --multifetch=N" download N packages in parallel (max 10) .RE .RS 4 .RE -.IP "\fBsecurity\fR" 4 -.IX Item "security" +.IP "[1] \fBsecurity\fR" 4 +.IX Item "[1] security" security infrastructure functions .RS 4 -.IP "\fBoscheck\fR" 4 -.IX Item "oscheck" +.IP "[2] \fBoscheck\fR" 4 +.IX Item "[2] oscheck" verify installed files using stored checksums .RS 4 -.IP "\fB\-\-mtime\fR" 4 -.IX Item "--mtime" +.IP "[3] \fB\-\-mtime\fR" 4 +.IX Item "[3] --mtime" consider mtime instead of \s-1SHA256\s0 (false positives ahead) -.RE -.RS 4 -.RE -.IP "\fB\-\-assimilate\fR" 4 -.IX Item "--assimilate" +.IP "[3] \fB\-\-assimilate\fR" 4 +.IX Item "[3] --assimilate" update hashes and mtime (useful after editing config files) +.IP "[3] \fB\-\-reinstall\fR" 4 +.IX Item "[3] --reinstall" +reinstall faulty packages +.IP "[3] \fB\-\-quiet\fR" 4 +.IX Item "[3] --quiet" +show less details (useful for scripting) +.IP "[3] \fB\-\-verbose\fR" 4 +.IX Item "[3] --verbose" +also list removed files .RE .RS 4 .RE -.IP "\fB\-\-quiet\fR" 4 -.IX Item "--quiet" -show less details (useful for scripting) -.IP "\fB\-\-verbose\fR" 4 -.IX Item "--verbose" -also list removed files -.IP "\fB\-\-reinstall\fR" 4 -.IX Item "--reinstall" -reinstall faulty packages -.IP "\fBupdate\fR" 4 -.IX Item "update" +.IP "[2] \fBupdate\fR" 4 +.IX Item "[2] update" download the latest Security Advisories .RS 4 -.IP "\fB\-\-force\fR" 4 -.IX Item "--force" +.IP "[3] \fB\-\-force\fR" 4 +.IX Item "[3] --force" force download even if already up-to-date .RE .RS 4 .RE -.IP "\fBlist\fR" 4 -.IX Item "list" +.IP "[2] \fBlist\fR" 4 +.IX Item "[2] list" list all the available Security Advisories -.IP "\fB\-\-affected\fR" 4 -.IX Item "--affected" +.RS 4 +.IP "[3] \fB\-\-affected\fR" 4 +.IX Item "[3] --affected" list only affected -.IP "\fB\-\-unaffected\fR" 4 -.IX Item "--unaffected" +.IP "[3] \fB\-\-unaffected\fR" 4 +.IX Item "[3] --unaffected" list only unaffected -.IP "\fBinfo\fR" 4 -.IX Item "info" +.RE +.RS 4 +.RE +.IP "[2] \fBinfo\fR" 4 +.IX Item "[2] info" show information about provided advisories identifiers -.IP "\fBinstall\fR" 4 -.IX Item "install" +.IP "[2] \fBinstall\fR" 4 +.IX Item "[2] install" automatically install all the available security updates -.IP "\fB\-\-ask (\-a)\fR" 4 -.IX Item "--ask (-a)" +.RS 4 +.IP "[3] \fB\-\-ask\fR" 4 +.IX Item "[3] --ask" ask before making any changes -.IP "\fB\-\-fetch\fR" 4 -.IX Item "--fetch" +.IP "[3] \fB\-\-fetch\fR" 4 +.IX Item "[3] --fetch" just download packages -.IP "\fB\-\-pretend (\-p)\fR" 4 -.IX Item "--pretend (-p)" +.IP "[3] \fB\-\-pretend\fR" 4 +.IX Item "[3] --pretend" just show what would be done -.IP "\fB\-\-quiet (\-q)\fR" 4 -.IX Item "--quiet (-q)" +.IP "[3] \fB\-\-quiet\fR" 4 +.IX Item "[3] --quiet" show less details (useful for scripting) -.IP "\fBinstall\fR" 4 -.IX Item "install" +.RE +.RS 4 +.RE +.RE +.RS 4 +.RE +.IP "[1] \fBinstall\fR" 4 +.IX Item "[1] install" install atoms or binary packages .RS 4 -.IP "\fB\-\-ask (\-a)\fR" 4 -.IX Item "--ask (-a)" +.IP "[2] \fB\-\-ask\fR" 4 +.IX Item "[2] --ask" ask before making any changes -.IP "\fB\-\-pretend (\-p)\fR" 4 -.IX Item "--pretend (-p)" +.IP "[2] \fB\-\-pretend\fR" 4 +.IX Item "[2] --pretend" just show what would be done -.IP "\fB\-\-fetch\fR" 4 -.IX Item "--fetch" +.IP "[2] \fB\-\-fetch\fR" 4 +.IX Item "[2] --fetch" just download packages without doing the install -.IP "\fB\-\-nodeps\fR" 4 -.IX Item "--nodeps" +.IP "[2] \fB\-\-nodeps\fR" 4 +.IX Item "[2] --nodeps" do not pull in any dependency -.IP "\fB\-\-bdeps\fR" 4 -.IX Item "--bdeps" +.IP "[2] \fB\-\-bdeps\fR" 4 +.IX Item "[2] --bdeps" also pull in build-time dependencies -.IP "\fB\-\-resume\fR" 4 -.IX Item "--resume" +.IP "[2] \fB\-\-resume\fR" 4 +.IX Item "[2] --resume" resume previously interrupted operations -.IP "\fB\-\-skipfirst\fR" 4 -.IX Item "--skipfirst" +.IP "[2] \fB\-\-skipfirst\fR" 4 +.IX Item "[2] --skipfirst" used with \-\-resume, makes the first package in queue to be skipped -.IP "\fB\-\-clean\fR" 4 -.IX Item "--clean" +.IP "[2] \fB\-\-clean\fR" 4 +.IX Item "[2] --clean" remove downloaded packages after being used -.IP "\fB\-\-empty\fR" 4 -.IX Item "--empty" +.IP "[2] \fB\-\-empty\fR" 4 +.IX Item "[2] --empty" pull all the dependencies in, regardless their state -.IP "\fB\-\-relaxed\fR" 4 -.IX Item "--relaxed" +.IP "[2] \fB\-\-relaxed\fR" 4 +.IX Item "[2] --relaxed" calm down dependencies resolution algorithm (might be risky) -.IP "\fB\-\-deep\fR" 4 -.IX Item "--deep" +.IP "[2] \fB\-\-deep\fR" 4 +.IX Item "[2] --deep" makes dependency rules stricter -.IP "\fB\-\-verbose (\-v)\fR" 4 -.IX Item "--verbose (-v)" +.IP "[2] \fB\-\-verbose\fR" 4 +.IX Item "[2] --verbose" show more details about what is going on -.IP "\fB\-\-configfiles\fR" 4 -.IX Item "--configfiles" +.IP "[2] \fB\-\-configfiles\fR" 4 +.IX Item "[2] --configfiles" makes old configuration files to be removed -.IP "\fB\-\-multifetch\fR" 4 -.IX Item "--multifetch" +.IP "[2] \fB\-\-multifetch\fR" 4 +.IX Item "[2] --multifetch" download multiple packages in parallel (default 3) -.IP "\fB\-\-multifetch=N\fR" 4 -.IX Item "--multifetch=N" +.IP "[2] \fB\-\-multifetch=N\fR" 4 +.IX Item "[2] --multifetch=N" download N packages in parallel (max 10) .RE .RS 4 .RE -.IP "\fBsource\fR" 4 -.IX Item "source" +.IP "[1] \fBsource\fR" 4 +.IX Item "[1] source" download atoms source code .RS 4 -.IP "\fB\-\-ask (\-a)\fR" 4 -.IX Item "--ask (-a)" +.IP "[2] \fB\-\-ask\fR" 4 +.IX Item "[2] --ask" ask before making any changes -.IP "\fB\-\-pretend (\-p)\fR" 4 -.IX Item "--pretend (-p)" +.IP "[2] \fB\-\-pretend\fR" 4 +.IX Item "[2] --pretend" just show what would be done -.IP "\fB\-\-nodeps\fR" 4 -.IX Item "--nodeps" +.IP "[2] \fB\-\-nodeps\fR" 4 +.IX Item "[2] --nodeps" do not pull in any dependency -.IP "\fB\-\-relaxed\fR" 4 -.IX Item "--relaxed" +.IP "[2] \fB\-\-relaxed\fR" 4 +.IX Item "[2] --relaxed" calm down dependencies resolution algorithm (might be risky) -.IP "\fB\-\-savehere\fR" 4 -.IX Item "--savehere" +.IP "[2] \fB\-\-savehere\fR" 4 +.IX Item "[2] --savehere" save sources in current working directory .RE .RS 4 .RE -.IP "\fBfetch\fR" 4 -.IX Item "fetch" +.IP "[1] \fBfetch\fR" 4 +.IX Item "[1] fetch" just download packages without doing the install .RS 4 -.IP "\fB\-\-ask (\-a)\fR" 4 -.IX Item "--ask (-a)" +.IP "[2] \fB\-\-ask\fR" 4 +.IX Item "[2] --ask" ask before making any changes -.IP "\fB\-\-pretend (\-p)\fR" 4 -.IX Item "--pretend (-p)" +.IP "[2] \fB\-\-pretend\fR" 4 +.IX Item "[2] --pretend" just show what would be done -.IP "\fB\-\-nodeps\fR" 4 -.IX Item "--nodeps" +.IP "[2] \fB\-\-nodeps\fR" 4 +.IX Item "[2] --nodeps" do not pull in any dependency -.IP "\fB\-\-relaxed\fR" 4 -.IX Item "--relaxed" +.IP "[2] \fB\-\-relaxed\fR" 4 +.IX Item "[2] --relaxed" calm down dependencies resolution algorithm (might be risky) -.IP "\fB\-\-multifetch\fR" 4 -.IX Item "--multifetch" +.IP "[2] \fB\-\-multifetch\fR" 4 +.IX Item "[2] --multifetch" download multiple packages in parallel (default 3) -.IP "\fB\-\-multifetch=N\fR" 4 -.IX Item "--multifetch=N" +.IP "[2] \fB\-\-multifetch=N\fR" 4 +.IX Item "[2] --multifetch=N" download N packages in parallel (max 10) .RE .RS 4 .RE -.IP "\fBremove\fR" 4 -.IX Item "remove" +.IP "[1] \fBremove\fR" 4 +.IX Item "[1] remove" remove one or more packages .RS 4 -.IP "\fB\-\-ask (\-a)\fR" 4 -.IX Item "--ask (-a)" +.IP "[2] \fB\-\-ask\fR" 4 +.IX Item "[2] --ask" ask before making any changes -.IP "\fB\-\-pretend (\-p)\fR" 4 -.IX Item "--pretend (-p)" +.IP "[2] \fB\-\-pretend\fR" 4 +.IX Item "[2] --pretend" just show what would be done -.IP "\fB\-\-nodeps\fR" 4 -.IX Item "--nodeps" +.IP "[2] \fB\-\-nodeps\fR" 4 +.IX Item "[2] --nodeps" do not pull in any dependency -.IP "\fB\-\-deep\fR" 4 -.IX Item "--deep" +.IP "[2] \fB\-\-deep\fR" 4 +.IX Item "[2] --deep" also pull unused dependencies where reverse deps list is empty -.IP "\fB\-\-empty\fR" 4 -.IX Item "--empty" +.IP "[2] \fB\-\-empty\fR" 4 +.IX Item "[2] --empty" when used with \-\-deep, helps the removal of virtual packages -.IP "\fB\-\-configfiles\fR" 4 -.IX Item "--configfiles" +.IP "[2] \fB\-\-configfiles\fR" 4 +.IX Item "[2] --configfiles" makes configuration files to be removed -.IP "\fB\-\-force\-system\fR" 4 -.IX Item "--force-system" -dangerous: forces system packages removal, do not use this -.IP "\fB\-\-resume\fR" 4 -.IX Item "--resume" +.IP "[2] \fB\-\-force\-system\fR" 4 +.IX Item "[2] --force-system" +dangerous: forces system packages removal, do not use this! +.IP "[2] \fB\-\-resume\fR" 4 +.IX Item "[2] --resume" resume previously interrupted operations .RE .RS 4 .RE -.IP "\fBmask\fR" 4 -.IX Item "mask" +.IP "[1] \fBmask\fR" 4 +.IX Item "[1] mask" mask one or more packages .RS 4 -.IP "\fB\-\-ask (\-a)\fR" 4 -.IX Item "--ask (-a)" +.IP "[2] \fB\-\-ask\fR" 4 +.IX Item "[2] --ask" ask before making any changes -.IP "\fB\-\-pretend (\-p)\fR" 4 -.IX Item "--pretend (-p)" +.IP "[2] \fB\-\-pretend\fR" 4 +.IX Item "[2] --pretend" just show what would be done .RE .RS 4 .RE -.IP "\fBunmask\fR" 4 -.IX Item "unmask" +.IP "[1] \fBunmask\fR" 4 +.IX Item "[1] unmask" unmask one or more packages .RS 4 -.IP "\fB\-\-ask (\-a)\fR" 4 -.IX Item "--ask (-a)" +.IP "[2] \fB\-\-ask\fR" 4 +.IX Item "[2] --ask" ask before making any changes -.IP "\fB\-\-pretend (\-p)\fR" 4 -.IX Item "--pretend (-p)" +.IP "[2] \fB\-\-pretend\fR" 4 +.IX Item "[2] --pretend" just show what would be done .RE .RS 4 .RE -.IP "\fBconfig\fR" 4 -.IX Item "config" +.IP "[1] \fBconfig\fR" 4 +.IX Item "[1] config" configure one or more installed packages .RS 4 -.IP "\fB\-\-ask (\-a)\fR" 4 -.IX Item "--ask (-a)" +.IP "[2] \fB\-\-ask\fR" 4 +.IX Item "[2] --ask" ask before making any changes -.IP "\fB\-\-pretend (\-p)\fR" 4 -.IX Item "--pretend (-p)" -just show what would be done -.IP "\fBdeptest\fR" 4 -.IX Item "deptest" -look for unsatisfied dependencies -.IP "\fB\-\-quiet (\-q)\fR" 4 -.IX Item "--quiet (-q)" -show less details (useful for scripting) -.IP "\fB\-\-ask (\-a)\fR" 4 -.IX Item "--ask (-a)" -ask before making any changes -.IP "\fB\-\-pretend (\-p)\fR" 4 -.IX Item "--pretend (-p)" +.IP "[2] \fB\-\-pretend\fR" 4 +.IX Item "[2] --pretend" just show what would be done .RE .RS 4 .RE -.IP "\fBunusedpackages\fR" 4 -.IX Item "unusedpackages" +.IP "[1] \fBdeptest\fR" 4 +.IX Item "[1] deptest" +look for unsatisfied dependencies +.RS 4 +.IP "[2] \fB\-\-quiet\fR" 4 +.IX Item "[2] --quiet" +show less details (useful for scripting) +.IP "[2] \fB\-\-ask\fR" 4 +.IX Item "[2] --ask" +ask before making any changes +.IP "[2] \fB\-\-pretend\fR" 4 +.IX Item "[2] --pretend" +just show what would be done +.RE +.RS 4 +.RE +.IP "[1] \fBunusedpackages\fR" 4 +.IX Item "[1] unusedpackages" look for unused packages (pay attention) .RS 4 -.IP "\fB\-\-quiet (\-q)\fR" 4 -.IX Item "--quiet (-q)" +.IP "[2] \fB\-\-quiet\fR" 4 +.IX Item "[2] --quiet" show less details (useful for scripting) -.IP "\fB\-\-sortbysize\fR" 4 -.IX Item "--sortbysize" +.IP "[2] \fB\-\-sortbysize\fR" 4 +.IX Item "[2] --sortbysize" sort packages by disk size .RE .RS 4 .RE -.IP "\fBlibtest\fR" 4 -.IX Item "libtest" +.IP "[1] \fBlibtest\fR" 4 +.IX Item "[1] libtest" look for missing libraries .RS 4 -.IP "\fB\-\-dump\fR" 4 -.IX Item "--dump" +.IP "[2] \fB\-\-dump\fR" 4 +.IX Item "[2] --dump" dump results to files -.IP "\fB\-\-listfiles\fR" 4 -.IX Item "--listfiles" +.IP "[2] \fB\-\-listfiles\fR" 4 +.IX Item "[2] --listfiles" print broken files to stdout -.IP "\fB\-\-quiet (\-q)\fR" 4 -.IX Item "--quiet (-q)" +.IP "[2] \fB\-\-quiet\fR" 4 +.IX Item "[2] --quiet" show less details (useful for scripting) -.IP "\fB\-\-ask (\-a)\fR" 4 -.IX Item "--ask (-a)" +.IP "[2] \fB\-\-ask\fR" 4 +.IX Item "[2] --ask" ask before making any changes -.IP "\fB\-\-pretend (\-p)\fR" 4 -.IX Item "--pretend (-p)" +.IP "[2] \fB\-\-pretend\fR" 4 +.IX Item "[2] --pretend" just show what would be done .RE .RS 4 .RE -.IP "\fBconf\fR" 4 -.IX Item "conf" +.IP "[1] \fBconf\fR" 4 +.IX Item "[1] conf" configuration files update tool .RS 4 -.IP "\fBinfo\fR" 4 -.IX Item "info" +.IP "[2] \fBinfo\fR" 4 +.IX Item "[2] info" show configuration files to be updated -.IP "\fBupdate\fR" 4 -.IX Item "update" +.IP "[2] \fBupdate\fR" 4 +.IX Item "[2] update" run the configuration files update function .RE .RS 4 .RE -.IP "\fBquery\fR" 4 -.IX Item "query" +.IP "[1] \fBquery\fR" 4 +.IX Item "[1] query" do misc queries on repository and local databases .RS 4 -.IP "\fBbelongs\fR" 4 -.IX Item "belongs" +.IP "[2] \fBbelongs\fR" 4 +.IX Item "[2] belongs" search from what package a file belongs -.IP "\fBchangelog\fR" 4 -.IX Item "changelog" +.IP "[2] \fBchangelog\fR" 4 +.IX Item "[2] changelog" show packages changelog -.IP "\fBrevdeps\fR" 4 -.IX Item "revdeps" +.IP "[2] \fBrevdeps\fR" 4 +.IX Item "[2] revdeps" search what packages depend on the provided atoms -.IP "\fBdescription\fR" 4 -.IX Item "description" +.IP "[2] \fBdescription\fR" 4 +.IX Item "[2] description" search packages by description -.IP "\fBfiles\fR" 4 -.IX Item "files" +.IP "[2] \fBfiles\fR" 4 +.IX Item "[2] files" show files owned by the provided atoms -.IP "\fBinstalled\fR" 4 -.IX Item "installed" +.IP "[2] \fBinstalled\fR" 4 +.IX Item "[2] installed" search a package into the local database -.IP "\fBlicense\fR" 4 -.IX Item "license" +.IP "[2] \fBlicense\fR" 4 +.IX Item "[2] license" show packages owning the provided licenses -.IP "\fBlist\fR" 4 -.IX Item "list" +.IP "[2] \fBlist\fR" 4 +.IX Item "[2] list" list packages based on the chosen parameter below .RS 4 -.IP "\fBinstalled\fR" 4 -.IX Item "installed" +.IP "[3] \fBinstalled\fR" 4 +.IX Item "[3] installed" list installed packages +.IP "[3] \fBavailable [repos]\fR" 4 +.IX Item "[3] available [repos]" +list available packages .RE .RS 4 .RE -.IP "\fBmimetype\fR" 4 -.IX Item "mimetype" +.IP "[2] \fBmimetype\fR" 4 +.IX Item "[2] mimetype" search packages able to handle given mimetypes .RS 4 -.IP "\fB\-\-installed\fR" 4 -.IX Item "--installed" -search inside installed packages +.IP "[3] \fB\-\-installed\fR" 4 +.IX Item "[3] --installed" +search among installed packages .RE .RS 4 .RE -.IP "\fBassociate\fR" 4 -.IX Item "associate" +.IP "[2] \fBassociate\fR" 4 +.IX Item "[2] associate" associate given file paths to applications able to read them .RS 4 -.IP "\fB\-\-installed\fR" 4 -.IX Item "--installed" -search inside installed packages +.IP "[3] \fB\-\-installed\fR" 4 +.IX Item "[3] --installed" +search among installed packages .RE .RS 4 .RE -.IP "\fBneeded\fR" 4 -.IX Item "needed" +.IP "[2] \fBneeded\fR" 4 +.IX Item "[2] needed" show runtime libraries needed by the provided atoms -.IP "\fBorphans\fR" 4 -.IX Item "orphans" +.IP "[2] \fBorphans\fR" 4 +.IX Item "[2] orphans" search files that do not belong to any package -.IP "\fBremoval\fR" 4 -.IX Item "removal" +.IP "[2] \fBremoval\fR" 4 +.IX Item "[2] removal" show the removal tree for the specified atoms -.IP "\fBrequired\fR" 4 -.IX Item "required" +.IP "[2] \fBrequired\fR" 4 +.IX Item "[2] required" show atoms needing the provided libraries -.IP "\fBsets\fR" 4 -.IX Item "sets" +.IP "[2] \fBsets\fR" 4 +.IX Item "[2] sets" search available package sets -.IP "\fBslot\fR" 4 -.IX Item "slot" +.IP "[2] \fBslot\fR" 4 +.IX Item "[2] slot" show packages owning the provided slot -.IP "\fBtags\fR" 4 -.IX Item "tags" -show packages owning the specified tags -.IP "\fBrevisions\fR" 4 -.IX Item "revisions" -show installed packages owning the specified revisions -.IP "\fBgraph\fR" 4 -.IX Item "graph" +.IP "[2] \fBtags\fR" 4 +.IX Item "[2] tags" +show packages owning the provided tags +.IP "[2] \fBgraph\fR" 4 +.IX Item "[2] graph" show direct depdendencies tree for provided installable atoms .RS 4 -.IP "\fB\-\-complete\fR" 4 -.IX Item "--complete" +.IP "[3] \fB\-\-complete\fR" 4 +.IX Item "[3] --complete" include system packages, build deps and circularity information .RE .RS 4 .RE -.IP "\fBrevgraph\fR" 4 -.IX Item "revgraph" +.IP "[2] \fBrevgraph\fR" 4 +.IX Item "[2] revgraph" show reverse depdendencies tree for provided installed atoms .RS 4 -.IP "\fB\-\-complete\fR" 4 -.IX Item "--complete" +.IP "[3] \fB\-\-complete\fR" 4 +.IX Item "[3] --complete" include system packages, build deps and circularity information .RE .RS 4 .RE -.IP "\fB\-\-verbose (\-v)\fR" 4 -.IX Item "--verbose (-v)" +.IP "[2] \fB\-\-verbose\fR" 4 +.IX Item "[2] --verbose" show more details -.IP "\fB\-\-quiet (\-q)\fR" 4 -.IX Item "--quiet (-q)" +.IP "[2] \fB\-\-quiet\fR" 4 +.IX Item "[2] --quiet" print results in a scriptable way .RE .RS 4 .RE .SH "EXTENDED_OPTIONS" .IX Header "EXTENDED_OPTIONS" -.IP "\fBsmart\fR" 4 -.IX Item "smart" +.IP "[1] \fBsmart\fR" 4 +.IX Item "[1] smart" handles extended functionalities .RS 4 -.IP "\fBapplication\fR" 4 -.IX Item "application" +.IP "[2] \fBapplication\fR" 4 +.IX Item "[2] application" make a smart application for the provided atoms (experimental) -.IP "\fBpackage\fR" 4 -.IX Item "package" +.IP "[2] \fBpackage\fR" 4 +.IX Item "[2] package" make a smart package for the provided atoms (multiple packages into one file) -.IP "\fBquickpkg\fR" 4 -.IX Item "quickpkg" +.IP "[2] \fBquickpkg\fR" 4 +.IX Item "[2] quickpkg" recreate an Entropy package from your System .RS 4 -.IP "\fB\-\-savedir\fR" 4 -.IX Item "--savedir" +.IP "[3] \fB\-\-savedir\fR" 4 +.IX Item "[3] --savedir" save new packages into the specified directory .RE .RS 4 .RE -.IP "\fBinflate\fR" 4 -.IX Item "inflate" +.IP "[2] \fBinflate\fR" 4 +.IX Item "[2] inflate" convert provided Source Package Manager package files into Entropy packages .RS 4 -.IP "\fB\-\-savedir\fR" 4 -.IX Item "--savedir" +.IP "[3] \fB\-\-savedir\fR" 4 +.IX Item "[3] --savedir" save new packages into the specified directory .RE .RS 4 .RE -.IP "\fBdeflate\fR" 4 -.IX Item "deflate" +.IP "[2] \fBdeflate\fR" 4 +.IX Item "[2] deflate" convert provided Entropy packages into Source Package Manager ones .RS 4 -.IP "\fB\-\-savedir\fR" 4 -.IX Item "--savedir" +.IP "[3] \fB\-\-savedir\fR" 4 +.IX Item "[3] --savedir" save new packages into the specified directory .RE .RS 4 .RE -.IP "\fBextract\fR" 4 -.IX Item "extract" +.IP "[2] \fBextract\fR" 4 +.IX Item "[2] extract" extract Entropy metadata from provided Entropy package files .RS 4 -.IP "\fB\-\-savedir\fR" 4 -.IX Item "--savedir" +.IP "[3] \fB\-\-savedir\fR" 4 +.IX Item "[3] --savedir" save new metadata into the specified directory .RE .RS 4 @@ -741,143 +756,143 @@ save new metadata into the specified directory .RE .RS 4 .RE -.IP "\fBrescue\fR" 4 -.IX Item "rescue" +.IP "[1] \fBrescue\fR" 4 +.IX Item "[1] rescue" contains System rescue tools .RS 4 -.IP "\fBcheck\fR" 4 -.IX Item "check" +.IP "[2] \fBcheck\fR" 4 +.IX Item "[2] check" check installed packages repository for errors -.IP "\fBvacuum\fR" 4 -.IX Item "vacuum" +.IP "[2] \fBvacuum\fR" 4 +.IX Item "[2] vacuum" remove installed packages repository internal indexes to save disk space -.IP "\fBgenerate\fR" 4 -.IX Item "generate" +.IP "[2] \fBgenerate\fR" 4 +.IX Item "[2] generate" generate installed packages database using Source Package Manager repositories -.IP "\fBresurrect\fR" 4 -.IX Item "resurrect" +.IP "[2] \fBresurrect\fR" 4 +.IX Item "[2] resurrect" generate installed packages database using files on the system [last hope] -.IP "\fBspmuids\fR" 4 -.IX Item "spmuids" +.IP "[2] \fBspmuids\fR" 4 +.IX Item "[2] spmuids" regenerate \s-1SPM\s0 UIDs map (\s-1SPM\s0 <\-> Entropy packages) -.IP "\fBspmsync\fR" 4 -.IX Item "spmsync" +.IP "[2] \fBspmsync\fR" 4 +.IX Item "[2] spmsync" makes Entropy aware of your Source Package Manager updated packages -.IP "\fBbackup\fR" 4 -.IX Item "backup" +.IP "[2] \fBbackup\fR" 4 +.IX Item "[2] backup" backup the current Entropy installed packages database -.IP "\fBrestore\fR" 4 -.IX Item "restore" +.IP "[2] \fBrestore\fR" 4 +.IX Item "[2] restore" restore a previously backed up Entropy installed packages database .RE .RS 4 .RE -.IP "\fBcommunity\fR" 4 -.IX Item "community" +.IP "[1] \fBcommunity\fR" 4 +.IX Item "[1] community" handles community-side features .RS 4 -.IP "\fBrepos\fR" 4 -.IX Item "repos" +.IP "[2] \fBrepos\fR" 4 +.IX Item "[2] repos" community repositories management functions .RS 4 -.IP "\fBupdate\fR" 4 -.IX Item "update" +.IP "[3] \fBupdate\fR" 4 +.IX Item "[3] update" scan the System looking for newly compiled packages .RS 4 -.IP "\fB\-\-seekstore\fR" 4 -.IX Item "--seekstore" +.IP "[4] \fB\-\-seekstore\fR" 4 +.IX Item "[4] --seekstore" analyze the Entropy Store directory directly -.IP "\fB\-\-repackage " 4 -.IX Item "--repackage " +.IP "[4] \fB\-\-repackage \fR" 4 +.IX Item "[4] --repackage " repackage the specified atoms -.IP "\fB\-\-noask\fR" 4 -.IX Item "--noask" +.IP "[4] \fB\-\-noask\fR" 4 +.IX Item "[4] --noask" do not ask anything except critical things -.IP "\fB\-\-atoms " 4 -.IX Item "--atoms " +.IP "[4] \fB\-\-atoms \fR" 4 +.IX Item "[4] --atoms " manage only the specified atoms -.IP "\fB\-\-interactive\fR" 4 -.IX Item "--interactive" +.IP "[4] \fB\-\-interactive\fR" 4 +.IX Item "[4] --interactive" run in interactive mode (asking things one by one) .RE .RS 4 .RE -.IP "\fBinject " 4 -.IX Item "inject " +.IP "[3] \fBinject \fR" 4 +.IX Item "[3] inject " add binary packages to repository w/o affecting scopes (multipackages) .RE .RS 4 .RE -.IP "\fBmirrors\fR" 4 -.IX Item "mirrors" +.IP "[2] \fBmirrors\fR" 4 +.IX Item "[2] mirrors" community repositories mirrors management functions .RS 4 -.IP "\fBsync\fR" 4 -.IX Item "sync" +.IP "[3] \fBsync\fR" 4 +.IX Item "[3] sync" sync packages, database and also do some tidy .RS 4 -.IP "\fB\-\-noask\fR" 4 -.IX Item "--noask" +.IP "[4] \fB\-\-noask\fR" 4 +.IX Item "[4] --noask" do not ask anything except critical things -.IP "\fB\-\-syncall\fR" 4 -.IX Item "--syncall" +.IP "[4] \fB\-\-syncall\fR" 4 +.IX Item "[4] --syncall" sync all the configured repositories .RE .RS 4 .RE -.IP "\fBpackages-sync\fR" 4 -.IX Item "packages-sync" +.IP "[3] \fBpackages-sync\fR" 4 +.IX Item "[3] packages-sync" sync packages across primary mirrors .RS 4 -.IP "\fB\-\-ask\fR" 4 -.IX Item "--ask" +.IP "[4] \fB\-\-ask\fR" 4 +.IX Item "[4] --ask" ask before making any changes -.IP "\fB\-\-pretend\fR" 4 -.IX Item "--pretend" +.IP "[4] \fB\-\-pretend\fR" 4 +.IX Item "[4] --pretend" only show what would be done -.IP "\fB\-\-syncall\fR" 4 -.IX Item "--syncall" +.IP "[4] \fB\-\-syncall\fR" 4 +.IX Item "[4] --syncall" sync all the configured repositories -.IP "\fB\-\-do\-packages\-check\fR" 4 -.IX Item "--do-packages-check" +.IP "[4] \fB\-\-do\-packages\-check\fR" 4 +.IX Item "[4] --do-packages-check" also verify packages integrity .RE .RS 4 .RE -.IP "\fBrepo-sync\fR" 4 -.IX Item "repo-sync" +.IP "[3] \fBrepo-sync\fR" 4 +.IX Item "[3] repo-sync" sync the current repository database across primary mirrors .RS 4 -.IP "\fB\-\-syncall\fR" 4 -.IX Item "--syncall" +.IP "[4] \fB\-\-syncall\fR" 4 +.IX Item "[4] --syncall" sync all the configured repositories .RE .RS 4 .RE -.IP "\fBrepo-lock\fR" 4 -.IX Item "repo-lock" +.IP "[3] \fBrepo-lock\fR" 4 +.IX Item "[3] repo-lock" lock the current repository database (server-side) -.IP "\fBrepo-unlock\fR" 4 -.IX Item "repo-unlock" +.IP "[3] \fBrepo-unlock\fR" 4 +.IX Item "[3] repo-unlock" unlock the current repository database (server-side) -.IP "\fBrepo-download-lock\fR" 4 -.IX Item "repo-download-lock" +.IP "[3] \fBrepo-download-lock\fR" 4 +.IX Item "[3] repo-download-lock" lock the current repository database (client-side) -.IP "\fBrepo-download-unlock\fR" 4 -.IX Item "repo-download-unlock" +.IP "[3] \fBrepo-download-unlock\fR" 4 +.IX Item "[3] repo-download-unlock" unlock the current repository database (client-side) -.IP "\fBrepo-lock-status\fR" 4 -.IX Item "repo-lock-status" +.IP "[3] \fBrepo-lock-status\fR" 4 +.IX Item "[3] repo-lock-status" show current lock status -.IP "\fBtidy\fR" 4 -.IX Item "tidy" +.IP "[3] \fBtidy\fR" 4 +.IX Item "[3] tidy" remove binary packages not in repositories and expired -.IP "\fBvacuum\fR" 4 -.IX Item "vacuum" +.IP "[3] \fBvacuum\fR" 4 +.IX Item "[3] vacuum" clean unavaiable packages from mirrors (similar to tidy, but more nazi) .RS 4 -.IP "\fB\-\-days=" 4 -.IX Item "--days=" +.IP "[4] \fB\-\-days=\fR" 4 +.IX Item "[4] --days=" expiration days [default is: 0, dangerous!] .RE .RS 4 @@ -885,195 +900,214 @@ expiration days [default is: 0, dangerous!] .RE .RS 4 .RE -.IP "\fBrepo\fR" 4 -.IX Item "repo" +.IP "[2] \fBrepo\fR" 4 +.IX Item "[2] repo" manage a repository .RS 4 -.IP "\fB\-\-initialize\fR" 4 -.IX Item "--initialize" +.IP "[3] \fB\-\-initialize\fR" 4 +.IX Item "[3] --initialize" (re)initialize the current repository database .RS 4 -.IP "\fB\-\-empty\fR" 4 -.IX Item "--empty" +.IP "[4] \fB\-\-empty\fR" 4 +.IX Item "[4] --empty" do not refill database using packages on mirrors -.IP "\fBbump\fR" 4 -.IX Item "bump" +.IP "[4] \fB\-\-repo=\fR" 4 +.IX Item "[4] --repo=" +(re)create the database for the specified repository +.RE +.RS 4 +.RE +.IP "[3] \fBbump\fR" 4 +.IX Item "[3] bump" manually force a revision bump for the current repository database .RS 4 -.IP "\fB\-\-sync\fR" 4 -.IX Item "--sync" +.IP "[4] \fB\-\-sync\fR" 4 +.IX Item "[4] --sync" synchronize the database .RE .RS 4 .RE -.IP "\fBremove\fR" 4 -.IX Item "remove" +.IP "[3] \fBflushback [branches]\fR" 4 +.IX Item "[3] flushback [branches]" +flush back old branches packages to current branch +.IP "[3] \fBremove\fR" 4 +.IX Item "[3] remove" remove the provided atoms from the current repository database -.IP "\fBmultiremove\fR" 4 -.IX Item "multiremove" +.IP "[3] \fBmultiremove\fR" 4 +.IX Item "[3] multiremove" remove the provided injected atoms (all if no atom specified) -.RS 4 -.IP "\fB\-\-branch=" 4 -.IX Item "--branch=" -choose on what branch operating -.RE -.RS 4 -.RE -.IP "\fBcreate-empty-database\fR" 4 -.IX Item "create-empty-database" +.IP "[3] \fBcreate-empty-database\fR" 4 +.IX Item "[3] create-empty-database" create an empty repository database in the provided path -.IP "\fBswitchbranch >" 4 -.IX Item "switchbranch >" +.IP "[3] \fBswitchbranch \fR" 4 +.IX Item "[3] switchbranch " switch to the specified branch the provided atoms (or world) -.IP "\fBmd5remote\fR" 4 -.IX Item "md5remote" +.IP "[3] \fBmd5remote\fR" 4 +.IX Item "[3] md5remote" verify remote integrity of the provided atoms (or world) -.IP "\fBbackup\fR" 4 -.IX Item "backup" +.IP "[3] \fBbackup\fR" 4 +.IX Item "[3] backup" backup current repository database -.IP "\fBrestore\fR" 4 -.IX Item "restore" +.IP "[3] \fBrestore\fR" 4 +.IX Item "[3] restore" restore a previously backed-up repository database +.IP "[3] \fBspmuids\fR" 4 +.IX Item "[3] spmuids" +regenerate \s-1SPM\s0 UIDs map (\s-1SPM\s0 <\-> Entropy packages) +.IP "[3] \fBenable \fR" 4 +.IX Item "[3] enable " +enable the specified repository +.IP "[3] \fBdisable \fR" 4 +.IX Item "[3] disable " +disable the specified repository +.IP "[3] \fBstatus \fR" 4 +.IX Item "[3] status " +show the current Server Interface status +.IP "[3] \fBpackage-dep-check [atoms]\fR" 4 +.IX Item "[3] package-dep-check [atoms]" +check packages in repository for missing dependencies +.IP "[3] \fBpackage-dep [atoms]\fR" 4 +.IX Item "[3] package-dep [atoms]" +handle packages dependencies +.IP "[3] \fBpackage-tag [atoms]\fR" 4 +.IX Item "[3] package-tag [atoms]" +clone a package inside a repository assigning it an arbitrary tag +.IP "[3] \fBmove [atoms]\fR" 4 +.IX Item "[3] move [atoms]" +move packages from a repository to another +.RS 4 +.IP "[4] \fB\-\-deps\fR" 4 +.IX Item "[4] --deps" +pulls dependencies in .RE .RS 4 .RE -.IP "\fBspmuids\fR" 4 -.IX Item "spmuids" -regenerate \s-1SPM\s0 UIDs map (\s-1SPM\s0 <\-> Entropy packages) -.IP "\fBenable " 4 -.IX Item "enable " -enable the specified repository -.IP "\fBdisable " 4 -.IX Item "disable " -disable the specified repository -.IP "\fBstatus " 4 -.IX Item "status " -show the current Server Interface status -.IP "\fBpackage-dep " 4 -.IX Item "package-dep " -handle packages dependencies -.IP "\fBpackage-tag [atoms]>" 4 -.IX Item "package-tag [atoms]>" -clone a package inside a repository assigning it an arbitrary tag -.IP "\fBmove [atoms]>" 4 -.IX Item "move [atoms]>" -move packages from a repository to another -.IP "\fBcopy [atoms]>" 4 -.IX Item "copy [atoms]>" +.IP "[3] \fBcopy [atoms]\fR" 4 +.IX Item "[3] copy [atoms]" copy packages from a repository to another -.IP "\fBdefault " 4 -.IX Item "default " +.RS 4 +.IP "[4] \fB\-\-deps\fR" 4 +.IX Item "[4] --deps" +pulls dependencies in +.RE +.RS 4 +.RE +.IP "[3] \fBdefault \fR" 4 +.IX Item "[3] default " set the default repository .RE .RS 4 .RE -.IP "\fBkey\fR" 4 -.IX Item "key" +.IP "[2] \fBkey\fR" 4 +.IX Item "[2] key" manage repository digital signatures (OpenGPG) .RS 4 -.IP "\fBcreate [repos]\fR" 4 -.IX Item "create [repos]" +.IP "[3] \fBcreate [repos]\fR" 4 +.IX Item "[3] create [repos]" create keypair for repositories and sign packages -.IP "\fBdelete [repos]\fR" 4 -.IX Item "delete [repos]" +.IP "[3] \fBdelete [repos]\fR" 4 +.IX Item "[3] delete [repos]" delete keypair (and digital signatures) of repository -.IP "\fBstatus [repos]\fR" 4 -.IX Item "status [repos]" +.IP "[3] \fBstatus [repos]\fR" 4 +.IX Item "[3] status [repos]" show currently configured keys information for given repositories -.IP "\fBsign [repos]\fR" 4 -.IX Item "sign [repos]" +.IP "[3] \fBsign [repos]\fR" 4 +.IX Item "[3] sign [repos]" sign (or re-sign) packages in repository using currently set keypair -.IP "\fBimport >" 4 -.IX Item "import >" +.IP "[3] \fBimport \fR" 4 +.IX Item "[3] import " import keypair, bind to given repository -.IP "\fBexport-public >" 4 -.IX Item "export-public >" +.IP "[3] \fBexport-public \fR" 4 +.IX Item "[3] export-public " export public key of given repository -.RE -.RS 4 -.RE -.IP "\fBexport-private >" 4 -.IX Item "export-private >" +.IP "[3] \fBexport-private \fR" 4 +.IX Item "[3] export-private " export private key of given repository .RE .RS 4 .RE -.IP "\fBquery\fR" 4 -.IX Item "query" +.IP "[2] \fBquery\fR" 4 +.IX Item "[2] query" do some searches into community repository databases .RS 4 -.IP "\fBbelongs\fR" 4 -.IX Item "belongs" +.IP "[3] \fBbelongs\fR" 4 +.IX Item "[3] belongs" show from what package the provided files belong -.IP "\fBchangelog\fR" 4 -.IX Item "changelog" +.IP "[3] \fBchangelog\fR" 4 +.IX Item "[3] changelog" show packages changelog -.IP "\fBrevdeps\fR" 4 -.IX Item "revdeps" +.IP "[3] \fBrevdeps\fR" 4 +.IX Item "[3] revdeps" show what packages depend on the provided atoms -.IP "\fBdescription\fR" 4 -.IX Item "description" +.IP "[3] \fBdescription\fR" 4 +.IX Item "[3] description" search packages by description -.IP "\fBfiles\fR" 4 -.IX Item "files" +.IP "[3] \fBfiles\fR" 4 +.IX Item "[3] files" show files owned by the provided atoms -.IP "\fBlist\fR" 4 -.IX Item "list" +.IP "[3] \fBlist\fR" 4 +.IX Item "[3] list" list all the packages in the default repository -.IP "\fBneeded\fR" 4 -.IX Item "needed" +.IP "[3] \fBneeded\fR" 4 +.IX Item "[3] needed" show runtime libraries needed by the provided atoms -.IP "\fBsearch\fR" 4 -.IX Item "search" +.IP "[3] \fBsearch\fR" 4 +.IX Item "[3] search" search packages inside the default repository database -.IP "\fBsets\fR" 4 -.IX Item "sets" +.IP "[3] \fBsets\fR" 4 +.IX Item "[3] sets" search available package sets -.IP "\fBtags\fR" 4 -.IX Item "tags" +.IP "[3] \fBtags\fR" 4 +.IX Item "[3] tags" show packages owning the specified tags -.IP "\fB\-\-verbose\fR" 4 -.IX Item "--verbose" +.IP "[3] \fBrevisions\fR" 4 +.IX Item "[3] revisions" +show installed packages owning the specified revisions +.IP "[3] \fB\-\-verbose\fR" 4 +.IX Item "[3] --verbose" show more details -.IP "\fB\-\-quiet\fR" 4 -.IX Item "--quiet" +.IP "[3] \fB\-\-quiet\fR" 4 +.IX Item "[3] --quiet" print results in a scriptable way .RE .RS 4 .RE -.IP "\fBspm\fR" 4 -.IX Item "spm" +.IP "[2] \fBspm\fR" 4 +.IX Item "[2] spm" source package manager functions .RS 4 -.IP "\fBcompile\fR" 4 -.IX Item "compile" +.IP "[3] \fBcompile\fR" 4 +.IX Item "[3] compile" compilation function .RS 4 -.IP "\fBcategories\fR" 4 -.IX Item "categories" +.IP "[4] \fBcategories\fR" 4 +.IX Item "[4] categories" compile packages belonging to the provided categories .RS 4 -.IP "\fB\-\-list\fR" 4 -.IX Item "--list" +.IP "[5] \fB\-\-list\fR" 4 +.IX Item "[5] --list" just list packages +.IP "[5] \fB\-\-nooldslots\fR" 4 +.IX Item "[5] --nooldslots" +do not pull old package slots .RE .RS 4 .RE -.IP "\fBpkgset\fR" 4 -.IX Item "pkgset" +.IP "[4] \fBpkgset\fR" 4 +.IX Item "[4] pkgset" compile packages in provided package set names .RS 4 -.IP "\fB\-\-list\fR" 4 -.IX Item "--list" +.IP "[5] \fB\-\-list\fR" 4 +.IX Item "[5] --list" just list packages -.IP "\fB\-\-rebuild\fR" 4 -.IX Item "--rebuild" +.IP "[5] \fB\-\-rebuild\fR" 4 +.IX Item "[5] --rebuild" rebuild everything -.IP "\fB\-\-dbupdate\fR" 4 -.IX Item "--dbupdate" +.IP "[5] \fB\-\-dbupdate\fR" 4 +.IX Item "[5] --dbupdate" run database update if all went fine -.IP "\fB\-\-dbsync\fR" 4 -.IX Item "--dbsync" +.IP "[5] \fB\-\-dbsync\fR" 4 +.IX Item "[5] --dbsync" run mirror sync if all went fine .RE .RS 4 @@ -1081,76 +1115,79 @@ run mirror sync if all went fine .RE .RS 4 .RE -.IP "\fBorphans\fR" 4 -.IX Item "orphans" +.IP "[3] \fBorphans\fR" 4 +.IX Item "[3] orphans" scan orphaned packages on \s-1SPM\s0 .RE .RS 4 .RE -.IP "\fBnotice\fR" 4 -.IX Item "notice" +.IP "[2] \fBnotice\fR" 4 +.IX Item "[2] notice" notice board handling functions .RS 4 -.IP "\fBadd\fR" 4 -.IX Item "add" +.IP "[3] \fBadd\fR" 4 +.IX Item "[3] add" add a news item to the notice board -.IP "\fBremove\fR" 4 -.IX Item "remove" +.IP "[3] \fBremove\fR" 4 +.IX Item "[3] remove" remove a news item from the notice board -.IP "\fBread\fR" 4 -.IX Item "read" +.IP "[3] \fBread\fR" 4 +.IX Item "[3] read" read the current notice board .RE .RS 4 .RE -.IP "\fBdeptest\fR" 4 -.IX Item "deptest" +.IP "[2] \fBdeptest\fR" 4 +.IX Item "[2] deptest" look for unsatisfied dependencies across community repositories -.IP "\fBpkgtest\fR" 4 -.IX Item "pkgtest" +.IP "[2] \fBpkgtest\fR" 4 +.IX Item "[2] pkgtest" verify the integrity of local package files -.IP "\fBugc\fR" 4 -.IX Item "ugc" +.RE +.RS 4 +.RE +.IP "[1] \fBugc\fR" 4 +.IX Item "[1] ugc" handles User Generated Content features .RS 4 -.IP "\fBlogin " 4 -.IX Item "login " +.IP "[2] \fBlogin \fR" 4 +.IX Item "[2] login " login against a specified repository -.IP "\fBlogout " 4 -.IX Item "logout " +.IP "[2] \fBlogout \fR" 4 +.IX Item "[2] logout " logout from a specified repository .RS 4 -.IP "\fB\-\-force\fR" 4 -.IX Item "--force" +.IP "[3] \fB\-\-force\fR" 4 +.IX Item "[3] --force" force action .RE .RS 4 .RE -.IP "\fBdocuments " 4 -.IX Item "documents " +.IP "[2] \fBdocuments \fR" 4 +.IX Item "[2] documents " manage package documents for the selected repository (comments, files, videos) .RS 4 -.IP "\fBget " 4 -.IX Item "get " +.IP "[3] \fBget \fR" 4 +.IX Item "[3] get " get available documents for the specified package key (example: x11\-libs/qt) -.IP "\fBadd " 4 -.IX Item "add " +.IP "[3] \fBadd \fR" 4 +.IX Item "[3] add " add a new document to the specified package key (example: x11\-libs/qt) -.IP "\fBremove " 4 -.IX Item "remove " +.IP "[3] \fBremove \fR" 4 +.IX Item "[3] remove " remove documents from database using their identifiers .RE .RS 4 .RE -.IP "\fBvote " 4 -.IX Item "vote " +.IP "[2] \fBvote \fR" 4 +.IX Item "[2] vote " manage package votes for the selected repository .RS 4 -.IP "\fBget " 4 -.IX Item "get " +.IP "[3] \fBget \fR" 4 +.IX Item "[3] get " get vote for the specified package key (example: x11\-libs/qt) -.IP "\fBadd " 4 -.IX Item "add " +.IP "[3] \fBadd \fR" 4 +.IX Item "[3] add " add vote for the specified package key (example: x11\-libs/qt) .RE .RS 4 @@ -1158,27 +1195,27 @@ add vote for the specified package key (example: x11\-libs/qt) .RE .RS 4 .RE -.IP "\fBcache\fR" 4 -.IX Item "cache" +.IP "[1] \fBcache\fR" 4 +.IX Item "[1] cache" handles Entropy cache .RS 4 -.IP "\fBclean\fR" 4 -.IX Item "clean" +.IP "[2] \fBclean\fR" 4 +.IX Item "[2] clean" clean Entropy cache -.IP "\fB\-\-verbose\fR" 4 -.IX Item "--verbose" +.IP "[2] \fB\-\-verbose\fR" 4 +.IX Item "[2] --verbose" show more details -.IP "\fB\-\-quiet\fR" 4 -.IX Item "--quiet" +.IP "[2] \fB\-\-quiet\fR" 4 +.IX Item "[2] --quiet" print results in a scriptable way .RE .RS 4 .RE -.IP "\fBcleanup\fR" 4 -.IX Item "cleanup" +.IP "[1] \fBcleanup\fR" 4 +.IX Item "[1] cleanup" remove downloaded packages and clean temp. directories -.IP "\fB\-\-info\fR" 4 -.IX Item "--info" +.IP "[1] \fB\-\-info\fR" 4 +.IX Item "[1] --info" show system information .SH "ENVIRONMENT" .IX Header "ENVIRONMENT" @@ -1216,15 +1253,3 @@ Fabio Erculiani .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fIreagent\fR\|(1), \fIactivator\fR\|(1) -.SH "POD ERRORS" -.IX Header "POD ERRORS" -Hey! \fBThe above document had some coding errors, which are explained below:\fR -.IP "Around line 229:" 4 -.IX Item "Around line 229:" -\&'=item' outside of any '=over' -.IP "Around line 243:" 4 -.IX Item "Around line 243:" -\&'=item' outside of any '=over' -.IP "Around line 293:" 4 -.IX Item "Around line 293:" -\&'=item' outside of any '=over' diff --git a/docs/man/pod-generator/Pod.pm b/docs/man/pod-generator/Pod.pm new file mode 100644 index 000000000..74d3a6b38 --- /dev/null +++ b/docs/man/pod-generator/Pod.pm @@ -0,0 +1,173 @@ +use warnings; +use strict; +use 5.010; + +# by Enlik +# April 2011 + +package Pod; + +sub new { + my $class = shift; + my $strs = shift || die "specify parameter"; + + unless (ref $strs eq "ARRAY") { + die "wrong parameter"; + } + + my $self = { + strs => $strs + }; + + bless $self, $class; +} + +sub generate { + my $self = shift; + my @strs = @{$self->{strs}}; + + print q{ +=head1 NAME + +B - Official Sabayon Linux Package Manager Client + +=head1 SYNOPSIS + +B [action] [basic_options] [options|extended_options] [atom | package_file | @set] ... + +B [action] [basic_options] [options|extended_options] ... + +B --info + +B --help + +B --version + +=head1 DESCRIPTION + +B is the definitive (rofl)... scratch it. +B is the official command-line interface to the Entropy framework. Primarily +used to ease packages management on Gentoo-based, Entropy-enabled distributions. + +With B you can easily install and remove any application inside available and +enabled repositories: it's a binary package manager which brings the best from +apt, yum and rpm, keeping 100% backward Portage (see 'man emerge') compatibility. +Being Entropy a framework means that it's not just ended here. + +For example, through B you can build your own software repository (called +Community Repository), do searches, keep your system secure, download packages' +source code, sanity check your system, see and be part of the User Generated +Content produced by other users. + +}; + + my $indent_lvl = 0; + + for my $h (@strs) { + my ($indent, $cmd, $desc); + $indent = $h->{indent}; + $cmd = $h->{command}; + $desc = $h->{desc}; + + while ($indent_lvl > $indent) { + print "\n=back\n\n"; + $indent_lvl--; + } + while ($indent_lvl < $indent) { + print "\n=over\n\n"; + $indent_lvl++; + } + + if ($indent == 0) { + my $out; + given($desc) { + when (/Basic Options/) { + $out = "BASIC_OPTIONS"; + } + when (/Application Options/) { + $out = "OPTIONS"; + } + when(/Extended Options/) { + $out = "EXTENDED_OPTIONS"; + } + $out = uc($desc); + $out =~ s/\s/_/g; + } + $desc = $out; + print "=head1 ", $self->conv($desc), "\n"; + } + else { + if ($cmd) { + my $out = "[$indent] B<" . $self->conv($cmd) . ">"; + print "=item ", $out, "\n"; + } + + print "\n", $self->conv($desc), "\n\n"; + } + } + + print q{ +=back + +=head1 ENVIRONMENT + +B=1: if set, all the Entropy framework will never use its internal +on-disk cache. + + +B=N: if set to 1, 2 or 3 and used with 'B update', Entropy +repository synchronized will be force to use the provided EAPI to update +repositories. + +B=license_id1:license_id2:...: this is a way to avoid equo +asking to accept specific licenses. + +B=1: disable entropy coloured output. + +=head1 BUGS + +Please report bugs to http://bugs.sabayonlinux.org. +B has a nice bug-reporting feature: whenever a valid exception occurs, it +asks the user to automatically submit the issue. B: to do efficient bug +squashing, some hardware specs are going to be collected, ask wrote before +submitting any data. No personal data is going to be uploaded and your report +will be kept private. + +=head1 EXAMPLES + + work in progress + +=head1 EXIT STATUS + +B returns a zero exit status if the called command succeeded. Non zero is +returned in case of failure. + +=head1 AUTHOR + +Fabio Erculiani + +=head1 SEE ALSO + +reagent(1), activator(1)}; +} + +sub conv { + my $self = shift; + my $line = shift || return ""; + # $line =~ s//g; + # $line =~ s/>/E/g; + + my $c; + my $o = ""; + for my $c (split //,$line) { + if ($c eq "<") { $o .= "E" } + elsif ($c eq ">") { $o .= "E" } + else { $o .= $c } + } + $line = $o; + + $line =~ s/&/E/g; + $line; +} + +1; diff --git a/docs/man/pod-generator/halp.pl b/docs/man/pod-generator/halp.pl new file mode 100644 index 000000000..a4877c8b5 --- /dev/null +++ b/docs/man/pod-generator/halp.pl @@ -0,0 +1,101 @@ +#!/usr/bin/env perl + +use warnings; +use strict; +use 5.010; + +# tool to make a pod file generated from equo --help +# which can be used to make a manual page + +# A tip: +# if this tool gives badly formatted text due to missing \t etc. in equo +# output, it's easier to save equo output to file, correct it and pipe +# using cat. + +# by Enlik + +my @strs; +# @strs: { }, { }, ... +# el - hash: indent => <0..n>, command => , desc => + +# command line arg: +# -p generate pod file + +# pass to stdin equo --help (English), +# you may use: LANG=en_US.UTF-8 equo | perl + +if (@ARGV and $ARGV[0] eq "-p") { + require Pod; + @strs = parse_input(); + + my $conv = Pod->new(\@strs); + $conv->generate; +} +else { + print "bad command, use -p\n"; + exit 1; +} + +sub parse_input { + my @strs = (); + my $level; + my ($cmd, $desc); + + while (my $line = ) { + chomp $line; + + next unless $line; # omit empty + + # 0 level + if ($line =~ /^ \S/) { + $line = substr $line, 2; + $level = 0; + } + elsif ($line =~ /^\t/) { + $level = 0; + while ($line =~ /^\t/) { + $level++; + $line = substr $line, 1; + } + } + else { + if ($line and not $line =~ /~ equo ~/) { + die "badly formatted line: $line\n"; + } + next; + } + + if ($line =~ /^([^\t]+)\t+(.*)/) { + $cmd = $1; + $desc = $2; + } + else { + $cmd = ""; + $desc = $line; + } + ## hop upgrade your distribution to a new release (branch) + #if ($line =~ /^(\S+ <.+>)\s*(.*)/) { + #$cmd = $1; + #$desc = $2; + #} + ## notice [repos] repository notice board reader + #elsif ($line =~ /^(\S+ \[.+\])\s*(.*)/) { + #$cmd = $1; + #$desc = $2; + #} + ## search search packages in repositories + #elsif ($line =~ /^(\S+)\s*(.*)/) { + #$cmd = $1; + #$desc = $2; + #} + #else { + ## ? + #$level = 0; + #$cmd = ""; + #$desc = $line; + #} + + push @strs, { indent => $level, command => $cmd, desc => $desc }; + } + @strs; +}