Commit Graph

457 Commits

Author SHA1 Message Date
Xavier Delaruelle
63ca36960b doc: clarify unload sticky errors in design doc 2021-08-23 06:47:25 +02:00
Xavier Delaruelle
0f629c15b9 doc: same index template for mfcmd/mfvar than others 2021-08-22 14:46:50 +02:00
Xavier Delaruelle
f334210470 Enforce magic cookie in source and init/user/global rc
Enforce use of the module magic cookie (i.e., `#%Module`) at the start of
global or user rc files, `initrc` configuration file or any scriptfile
passed for evaluation to the `source` sub-command. These files are not
evaluated and an error is produced if the magic cookie is missing or if
the optional version number placed after the cookie string is higher than
the version of the `modulecmd.tcl` script in use.

Note that version 3.2 of Modules was already enforcing the magic cookie
for the user/global rc files.

This enforced back globally to ensure people understand, especially for
the source sub-command, that the script is made for module and it is not
a shell script. It will also help to protect module from automatically
evaluating files with expected file name but unrelated content.

This commit among things reverts 3fe71c0d.
2021-08-22 09:53:32 +02:00
Xavier Delaruelle
2c0323f85b doc: desc when --not-req option has been added 2021-08-20 06:58:34 +02:00
Xavier Delaruelle
97d3fa0308 doc: update desc. of unsetenv on unload in NEWS/man 2021-08-18 22:00:37 +02:00
Xavier Delaruelle
85546253c2 No error if variant unspecified on display mode
No error is raised when evaluating in `display` mode a modulefile without
a value specified for the variant it defines. This change helps to learn
all the variant a modulefile defines. As a result, the unspecified
variant is not instantiated in the ModuleVariant array variable.

Fixes #406.
2021-08-18 07:17:43 +02:00
Xavier Delaruelle
237755f9fb ts/doc: add try-load test/doc on 'module-info command' 2021-08-13 07:53:54 +02:00
Xavier Delaruelle
a4823b5691 doc: desc. new mode/cmd on 'module-info {mode,command}' 2021-08-13 07:53:54 +02:00
Xavier Delaruelle
26678c8fe2 doc: desc. refresh subcmd in module(1) 2021-08-13 07:53:54 +02:00
Xavier Delaruelle
7e962617e5 doc: clarify already defined path on use/{append,prepend}-path
Fixes #60.
2021-08-11 17:02:06 +02:00
Xavier Delaruelle
243729e9f6 Fix unuse when multiple paths are passed as single arg
Fix unuse sub-command when sereval modulepaths are specified as a single
argument (i.e., `/path/to/dir1:/path/to/dir2`). Enabled modulepaths were
not correctly detected when specified this way.
2021-08-11 15:28:39 +02:00
Xavier Delaruelle
c6ce9f600e doc: ignore ref count from *use/*-path subcmds 2021-08-11 14:07:16 +02:00
Xavier Delaruelle
47556d96da doc: desc removal from ref count var of elts added once 2021-08-08 17:56:23 +02:00
Xavier Delaruelle
579aad3e70 doc: update reference to renamed __MODULES_SHARE_* vars 2021-08-08 13:27:53 +02:00
Xavier Delaruelle
97447d40a3 doc: remove ref of __MODULES_LMNOTUASKED env var 2021-08-01 20:25:46 +02:00
Xavier Delaruelle
214fe6967a Release of version 5.0.0-alpha 2021-07-25 21:36:37 +02:00
Xavier Delaruelle
8adeee327d doc: update reference to renamed __MODULES_QUAR_* vars 2021-07-25 10:17:04 +02:00
Xavier Delaruelle
b31c0c7a61 doc: update reference to renamed __MODULES_LM* vars 2021-07-24 14:06:09 +02:00
Xavier Delaruelle
289e1a6348 Remove MODULES_USE_COMPAT_VERSION env variable 2021-07-24 14:06:09 +02:00
Xavier Delaruelle
16a8ccce76 Accept non-existent modulepath on use subcmd
Allow non-existent directory to be specified to use sub-command so
directory that does not exist yet could be added to MODULEPATH prior
being created.

Also it may allow a shared module configuration to define all existing
paths across the network but only some of these paths are enabled on a
given host.
2021-07-16 15:56:28 +02:00
Xavier Delaruelle
bf3b3a82f3 doc: advertise sh-to-mod/source-sh in FAQ 2021-07-16 15:56:07 +02:00
Xavier Delaruelle
3e705098d5 Release of version 4.8.0 2021-07-14 09:36:29 +02:00
Xavier Delaruelle
1159bfefc5 doc: desc. variant mfcmd in modulefile(4) 2021-07-12 21:14:06 +02:00
Xavier Delaruelle
54721d65ab doc: add 'Module variants' section in module(1) 2021-07-12 07:55:12 +02:00
Xavier Delaruelle
b77aa68984 doc: desc. variant specification in module(1)/modulefile(4) 2021-07-11 18:35:57 +02:00
Xavier Delaruelle
056a179766 doc: fix syntax of edit subcmd desc. in module(1) 2021-07-11 13:47:50 +02:00
Xavier Delaruelle
a015be2d26 doc: add variant info to module-info in modulefile(4) 2021-07-11 13:47:50 +02:00
Xavier Delaruelle
f77cde3eeb doc: desc. MODULES_VARIANT_SHORTCUT in module(1) 2021-07-11 13:47:50 +02:00
Xavier Delaruelle
54a510e373 doc: desc. MODULES_LMVARIANT in module(1) 2021-07-11 13:47:50 +02:00
Xavier Delaruelle
fe55bf40ae doc: desc. no implicit req if module not found by try-load 2021-07-06 07:51:41 +02:00
Xavier Delaruelle
592d1c7833 doc: desc. getenv on display eval mode in modulefile(4) 2021-07-06 07:51:41 +02:00
Xavier Delaruelle
d9c68cb126 doc: desc. ModuleVariant in modulefile(4) 2021-07-06 07:51:41 +02:00
Xavier Delaruelle
5f3e153fdb doc: mention getenv introduction release 2021-07-06 07:51:41 +02:00
Xavier Delaruelle
19d36b93df doc: desc. getvariant in modulefile(4) 2021-07-06 07:51:41 +02:00
Xavier Delaruelle
0114f34dd8 doc: use catch to get v3 module load behavior in modfile
Add description to the diff doc to get the behavior of Modules v3 back
when using `module load` command in modulefile. To pursue evaluation
even when the `module load` fails, enclose it within a `catch` Tcl
command.

Fixes #197.
2021-07-04 20:34:57 +02:00
Xavier Delaruelle
1a2de0570c doc: fix options on subcmd aliases in module(1) 2021-07-04 20:34:57 +02:00
Xavier Delaruelle
297cc4d04e doc: desc try-load in module(1) man 2021-07-04 20:34:57 +02:00
Xavier Delaruelle
aa04862eea doc: desc. try-load in diff doc 2021-06-30 21:55:57 +02:00
Xavier Delaruelle
8c246fac60 doc: refine desc of variant_shortcut in design 2021-06-28 22:09:15 +02:00
Xavier Delaruelle
fa44c979c1 doc: update boolean variant specs 2021-06-22 06:17:58 +02:00
Xavier Delaruelle
390390ceee doc: desc. is-dfl-specifically-asked in variant design 2021-06-21 20:43:48 +02:00
Xavier Delaruelle
ccfa9ce992 doc: desc. forbidden version variant in design doc 2021-06-21 20:43:48 +02:00
Xavier Delaruelle
37fcacf76e doc: desc variant in requirement spec in design doc 2021-06-21 20:43:48 +02:00
Xavier Delaruelle
3be071b70c doc: desc module-info {name,specified} & variant in design doc 2021-06-21 20:43:48 +02:00
Xavier Delaruelle
6837b39353 doc: module-info tags/loaded & variant in design doc 2021-06-21 20:43:48 +02:00
Xavier Delaruelle
6763c518e8 doc: fix module-info specified desc. when unloading variant 2021-06-21 20:43:48 +02:00
Xavier Delaruelle
3ae9a1697b doc/ts: no variant on module-info {alias,symbols,version} 2021-06-21 20:43:48 +02:00
Xavier Delaruelle
df573bee7a doc/ts: no variant on module-{alias,virtual,version} 2021-06-21 20:43:48 +02:00
Xavier Delaruelle
7aec88bf66 doc/ts: depre mod relying on default variant
When an optional requirement is loaded by not specifying its variant
value to rely on default, the Dependent Reload mechanism will miss to
detect the dependent module to reload, as variant is not specified on
command line thus it does not match the requirement specification prior
load.
2021-06-21 20:43:48 +02:00
Xavier Delaruelle
6cdf2a7031 doc: desc. use of variant on search contexts 2021-06-21 20:43:48 +02:00