Puppet: System Administration Automated

Support

Ticket #727 (closed defect: fixed)

Opened 1 year ago

Last modified 1 year ago

mount "ensure" parameter's documentation unclear

Reported by: porridge Assigned to: luke
Priority: normal Milestone:
Component: documentation Version: 0.23.0
Severity: normal Keywords: mount type
Cc: Triage Stage: Unreviewed
Attached Patches: Insufficient Complexity: Unknown

Description

The ensure parameter documentation says:

If the value is present, the mount is entered into the mount table, but not mounted, if it is absent,
the entry is removed from the mount table and the filesystem is unmounted if currently mounted, if it
is mounted, the filesystem is entered into the mount table and mounted. Valid values are
absent, mounted, present (also called unmounted).

It does not specify what happens when the value is "present" and the filesystem is mounted. Since it does not specify that, some people might infer that it leaves the mountpoint alone. In reality, it umounts it, which I think should be stated explicitly.

Also, the actual parameter values should be at least quoted, because in such a long sentence a non-native english speaker might easily get confused as to when "absent" refers to a parameter value or the actual absence of something.

Ideally, this would all be in a nice table, but I guess that's not easy to do.

Change History

07/20/07 18:31:24 changed by luke

  • status changed from new to closed.
  • resolution set to fixed.

Cleaned up in [2721].