From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id C40271382C5 for ; Sun, 24 Jan 2021 16:05:42 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 164C4E09F7; Sun, 24 Jan 2021 16:05:42 +0000 (UTC) Received: from smtp.gentoo.org (woodpecker.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id C3AC0E09F7 for ; Sun, 24 Jan 2021 16:05:41 +0000 (UTC) Received: from oystercatcher.gentoo.org (unknown [IPv6:2a01:4f8:202:4333:225:90ff:fed9:fc84]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 78A8A340C4B for ; Sun, 24 Jan 2021 16:05:40 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 29370476 for ; Sun, 24 Jan 2021 16:05:39 +0000 (UTC) From: "Aisha Tammy" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Aisha Tammy" Message-ID: <1611504262.a947a68e0bbbabb1a0e42edd35dec13281c6e727.epsilon-0@gentoo> Subject: [gentoo-commits] proj/sci:master commit in: sys-cluster/lmod/files/, sys-cluster/lmod/ X-VCS-Repository: proj/sci X-VCS-Files: sys-cluster/lmod/files/module.1-8.4.20 sys-cluster/lmod/lmod-8.4.20.ebuild sys-cluster/lmod/lmod-9999.ebuild X-VCS-Directories: sys-cluster/lmod/files/ sys-cluster/lmod/ X-VCS-Committer: epsilon-0 X-VCS-Committer-Name: Aisha Tammy X-VCS-Revision: a947a68e0bbbabb1a0e42edd35dec13281c6e727 X-VCS-Branch: master Date: Sun, 24 Jan 2021 16:05:39 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: ff74e31b-d896-4a39-8dda-701a755260a1 X-Archives-Hash: d4a4f05a8a4130e980bb864c92fcf0c7 commit: a947a68e0bbbabb1a0e42edd35dec13281c6e727 Author: Aisha Tammy aisha cc> AuthorDate: Sun Jan 24 16:03:25 2021 +0000 Commit: Aisha Tammy aisha 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 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 mclay@tacc.utexas.edu . +.Pp +The man page for Gentoo linux is maintained by the +.An Gentoo Science Project . 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 }