commit: a947a68e0bbbabb1a0e42edd35dec13281c6e727 Author: Aisha Tammy <gentoo <AT> aisha <DOT> cc> AuthorDate: Sun Jan 24 16:03:25 2021 +0000 Commit: Aisha Tammy <gentoo <AT> aisha <DOT> cc> CommitDate: Sun Jan 24 16:04:22 2021 +0000 URL: https://gitweb.gentoo.org/proj/sci.git/commit/?id=a947a68e
sys-cluster/lmod: add proper formatted manpage Package-Manager: Portage-3.0.13, Repoman-3.0.2 Signed-off-by: Aisha Tammy <gentoo <AT> aisha.cc> sys-cluster/lmod/files/module.1-8.4.20 | 388 +++++++++++++++++++++++++++++++++ sys-cluster/lmod/lmod-8.4.20.ebuild | 3 +- sys-cluster/lmod/lmod-9999.ebuild | 5 +- 3 files changed, 391 insertions(+), 5 deletions(-) diff --git a/sys-cluster/lmod/files/module.1-8.4.20 b/sys-cluster/lmod/files/module.1-8.4.20 new file mode 100644 index 000000000..4eb784a06 --- /dev/null +++ b/sys-cluster/lmod/files/module.1-8.4.20 @@ -0,0 +1,388 @@ +.Dd $Mdocdate: December 6 2020 $ +.Dt MODULE 1 +.Os +.Sh NAME +.Nm module +.Nd lmod environment modules manager +.Sh SYNOPSIS +.Nm module +.Op options +.Cm sub-command +.Op args ... +.Sh DESCRIPTION +.Nm +from +.Sy Lmod +is a +.Xr lua 1 +based program to manage the user environment under +Unix systems, specifically designed to easily handle +the +.Ev MODULEPATH +Hierarchical problem. +Environment Modules provide a convenient way to +dynamically change the users' environment through modulefiles. +This includes easily adding or removing directories to the +.Ev PATH , LD_LIBRARY_PATH +and other environment variables. +.Sh OPTIONS +The following +.Ar options +are available: +.Pp +.Bl -tag -width Ds -compact +.It Fl h , ? , H , -help +Show the help message. +.Pp +.It Fl -check_syntax , -checkSyntax +Only check the +.Nm +command syntax, do not load any modules. +.Pp +.It Fl -config +Report +.Sy Lmod +configuration. +.Pp +.It Fl -config_json +Report +.Sy Lmod +configuration in json format. +.Pp +.It Fl D +Write program tracing data to stderr. +.Pp +.It Fl d , -default +List default modules only when used with +.Cm avail . +.Pp +.It Fl -debug Ar dbglvl +.Sy VALUES : +1, 2, 3. +.Pp +Only write trace output with proper debug levels. +.Pp +.It Fl -dumpversion +Dump version in a machine readable way and quit. +.Pp +.It Fl -expert +Work in expert mode. +.Pp +.It Fl -force +Force removal of a sticky module or save an empty collection. +.Pp +.It Fl -gitversion +Dump git version in a machine readable way and quit. +.Pp +.It Fl -ignore_cache +Treat the cache file(s) as out-of-date. +.Pp +.It Fl -initial_load +Loading Lmod for first time in a user shell. +.Pp +.It Fl -latest +Load latest (ignore default). +.Pp +.It Fl -mt +Report Module Table State. +.Pp +.It Fl -no_redirect +Force output of +.Cm list , +.Cm avail +and +.Cm spider +to stderr. +.Pp +.It Fl -novice +Turn off +.Fl -expert +and +.Fl -quiet +flags. +.Pp +.It Fl -nx , -no_extensions +.Pp +.It Fl -pin_versions Ar pinVersions +When doing a restore use the specified version, do not follow defaults. +.Pp +.It Fl q , -quiet +Do not print out warnings. +.Pp +.It Fl r , -regexp +Use regular expression match. +.Pp +.It Fl -raw +Print modulefile in raw output when used with show. +.Pp +.It Fl -redirect +Send the output of +.Cm list , +.Cm avail +and +.Cm spider +to stdout (not stderr). +.Pp +.It Fl -regression_testing +Lmod regression testing. +.Pp +.It Fl -show_hidden +.Cm avail +and +.Cm spider +will report hidden modules. +.Pp +.It Fl -spider_timeout Ar timeout +A timeout for +.Cm spider . +.Pp +.It Fl s , -style Ar availStyle +.Sy DEFAULT : +system +Site controlled avail style. +.Pp +.It Fl T , -trace +.Pp +.It Fl t , -terse +Write out in machine readable format for +.Cm list , +.Cm avail , +.Cm spider +and +.Cm savelist . +.Pp +.It Fl -timer +Report run times. +.Pp +.It Fl v , -version +Print version info and quit. +.Pp +.It Fl -w , -width Ar twidth +Use +.Ar twidth +as max term width. +.El +.Sh SUB-COMMANDS +.Ss HELP +.Bl -tag -width Ds -compact +.It Cm help +Print the help message. +.Pp +.It Cm help Ar module Op moduleX moduleY ... +Print help messages from the given module(s). +.El +.Ss LOAD +.Bl -tag -width Ds -compact +.It Cm load , add Ar module Op moduleX moduleY ... +Load module(s) +.Pp +.It Cm try-load , try-add Ar module Op moduleX module Y ... +Load module(s), do not complain if not found +.Pp +.It Cm del , unload Ar module Op moduleX moduleY ... +Unload module(s), does not complain if not found +.Pp +.It Cm swap , sw , switch Ar m1 m2 +.Cm unload +.Ar m1 +and +.Cm load +.Ar m2 +.Pp +.It Cm purge +.Cm unload +all modules +.Pp +.It Cm refresh +Reload aliases from current list of modules. +.Pp +.It Cm update +Reload all currently loaded modules. +.El +.Ss SEARCH +.Bl -tag -width Ds -compact +.It Cm list +List all loaded modules. +.Pp +.It Cm list Ar s1 Op Ar s2 ... +List all loaded modules that match any of the given patterns. +.Pp +.It Cm avail , av Op Ar string +List all available modules. +Restricts to modules containing +.Ar string +if it is provided. +.Pp +.It Cm spider +List all possible modules. +.Pp +.It Cm spider Ar module +List all possible versions of that +.Ar module +file. +.Pp +.It Cm spider Ar string +List all modules that contain +.Ar string . +.Pp +.It Cm spider Ar name/version +Detailed information about that version of the module. +.Pp +.It Cm whatis Ar module +Print whatis information about the module. +.Pp +.It Cm keyword , key Ar string +Search all name and +.Cm whatis +that contain +.Ar string . +.El +.Pp +All searching commands ( +.Cm spider , +.Cm list , +.Cm avail , +.Cm keyword +) support regular expressions. +.Pp +For example, to find all modules that start with +.Sq p +or +.Sq P : +.D1 module -r spider '^p' +.Pp +Find all modules that have +.Dq mpi +in their name: +.D1 module -r spider mpi +.Pp +Find all modules that end with +.Dq mpi +in their name: +.D1 module -r spider 'mpi$' +.Ss COLLECTIONS +.Bl -tag -width Ds -compact +.It Cm save , s +Save the current list of modules to a user defined +.Dq default +collection. +.Pp +.It Cm save , s Ar name +Save the current list of modules to the +.Ar name +collection. +.Pp +.It Cm reset +The same as +.Cm restore +.Ar system . +.Pp +.It Cm restore , r +Restore modules from the user's +.Dq default +(if defined) or the system default. +.Pp +.It Cm restore , r Ar name +Restore modules from +.Ar name +collection. +.Pp +.It Cm restore Ar system +Restore module state to system defaults. +.Pp +.It Cm savelist +List of saved collections. +.Pp +.It Cm describe , mcc Ar name +Describe the contents of the +.Ar name +module collection. +.Pp +.It Cm disable Ar name +Disable (i.e. remove) the +.Ar name +collection. +.El +.Ss DEPRECATED +.Bl -tag -width Ds -compact +.It Cm getdefault Op Ar name +Load the +.Ar name +collection of modules or users +.Dq default +if no +.Ar name +given. +.Pp +Use +.Cm restore +Instead. +.Pp +.It Cm setdefault Op Ar name +Save current list of modules to +.Ar name +if given, otherwise save as the +.Dq default +list for the user. +.Pp +Use +.Cm save +instead. +.El +.Ss MISC +.Bl -tag -width Ds -compact +.It Cm is-loaded Ar modulefile +Return a true status if +.Ar module +is loaded. +.Pp +.It Cm is-avail Ar modulefile +Return a true status if +.Ar module +can be loaded. +.Pp +.It Cm show Ar modulefile +Show the commands in the +.Ar module +file. +.Pp +.It Cm use [-a] Ar path +Prepend or append +.Ar path +to +.Ev MODULEPATH . +.Pp +.It Cm unuse Ar path +Remove +.Ar path +from +.Ev MODULEPATH . +.Pp +.It Cm tablelist +Output list of active modules as a lua table. +.El +.Sh ENVIRONMENT +To print properties and warnings in color, set the +.Ev LMOD_COLORIZE +environment variable to +.Sy YES +.Sh SEE ALSO +.Bd -filled -offset indent +.TS +allbox tab(@); +le lw10. +Documentation@http://lmod.readthedocs.org +Github@https://github.com/TACC/Lmod +Sourceforge@https://lmod.sf.net +TACC Homepage@https://www.tacc.utexas.edu/research-development/tacc-projects/lmod +.TE +.Ed +.Pp +To report a bug please read +.Lk http://lmod.readthedocs.io/en/latest/075_bug_reporting.html +.Sh AUTHORS +Modules based on Lua, written by +.An Robert McLay Aq Mt [email protected] . +.Pp +The man page for Gentoo linux is maintained by the +.An Gentoo Science Project <[email protected]> . diff --git a/sys-cluster/lmod/lmod-8.4.20.ebuild b/sys-cluster/lmod/lmod-8.4.20.ebuild index 3d69b1e7d..4d56aa544 100644 --- a/sys-cluster/lmod/lmod-8.4.20.ebuild +++ b/sys-cluster/lmod/lmod-8.4.20.ebuild @@ -117,10 +117,9 @@ src_test() { src_install() { default - + newman "${FILESDIR}"/module.1-8.4.20 module.1 insinto /etc/profile.d newins "${ED}"/usr/share/Lmod/init/profile lmod.sh newins "${ED}"/usr/share/Lmod/init/profile.fish lmod.fish - keepdir /etc/modulefiles } diff --git a/sys-cluster/lmod/lmod-9999.ebuild b/sys-cluster/lmod/lmod-9999.ebuild index cc30e4b48..4d56aa544 100644 --- a/sys-cluster/lmod/lmod-9999.ebuild +++ b/sys-cluster/lmod/lmod-9999.ebuild @@ -1,4 +1,4 @@ -# Copyright 1999-2020 Gentoo Authors +# Copyright 1999-2021 Gentoo Authors # Distributed under the terms of the GNU General Public License v2 EAPI=7 @@ -117,10 +117,9 @@ src_test() { src_install() { default - + newman "${FILESDIR}"/module.1-8.4.20 module.1 insinto /etc/profile.d newins "${ED}"/usr/share/Lmod/init/profile lmod.sh newins "${ED}"/usr/share/Lmod/init/profile.fish lmod.fish - keepdir /etc/modulefiles }
