freebsd-dev/usr.sbin/bsdconfig/usermgmt
Devin Teske 052f89691c Standardize the way functions build their arguments leading up to a dialog
invocation. Specifically, "top-load" your arguments and in the order in-
which they will be displayed. For example, many [if not all] widgets display
information in the following order, top-to-bottom (visually):

+ backtitle (displayed behind the widget at top-left)
+ title (at the top of the `window')
+ prompt text (just below the title and above whatever widget you choose)
+ Depending on widget, _one_ of the following:
  - menu list
  - radio list
  - check list
  - text input box with initial text
  - [Xdialog(1)] 2x or 3x text input boxes
  - [dialog(1)] a multi-part form
  - progress bar
  - etc. (many more widget choices)
+ buttons (right below the selected widget)
+ [dialog(1)] the hline (displayed at bottom of `window')

NOTE: Xdialog(1) accepts and silently ignores --hline

When building local arguments for your dialog invocation, if the value can't
be cleanly loaded into a local, add "# Calculated below" to the end of the
local declaration while retaining the block order of argument declarations.

Move other local declarations that are not associated with this top-loading
the dialog arguments to right-above where they are first-used.

Also, standardize on the names of the arguments. For example, always use
$prompt (instead of sometimes $msg and sometimes $prompt); use $menu_list
or $shell_list or $radio_list for those respective widgets; ad nauseum.

While we're doing this, flush-out full arguments for many invocations that
were passing NULL strings (making it unapparent if you were staring at this
one invocation what argument that NULL string was supposed to represent).

Last, while we're in startup/rcconf let's remove the unnecessary use of a
GLOBAL (RCCONF_MENU_LIST) for the menu_list.
2013-06-02 20:02:50 +00:00
..
include UI improvements. First, implement --default-item whenever and wherever 2013-04-22 05:52:06 +00:00
share Standardize the way functions build their arguments leading up to a dialog 2013-06-02 20:02:50 +00:00
groupadd Centralize standard getopts arguments, both for convenience and to correct 2013-05-14 03:21:13 +00:00
groupdel Improve portion of the dialog(1) API in dialog.subr responsible for 2013-06-01 23:58:44 +00:00
groupedit Improve portion of the dialog(1) API in dialog.subr responsible for 2013-06-01 23:58:44 +00:00
groupinput Improve the dialog(1) API in dialog.subr by adding f_dialog_default_store() 2013-06-02 09:02:12 +00:00
INDEX
Makefile
USAGE Add new flags -d' (sets debug=1) and -D file' (sets debugFile) and 2013-04-22 05:02:34 +00:00
useradd Centralize standard getopts arguments, both for convenience and to correct 2013-05-14 03:21:13 +00:00
userdel Improve portion of the dialog(1) API in dialog.subr responsible for 2013-06-01 23:58:44 +00:00
useredit Improve portion of the dialog(1) API in dialog.subr responsible for 2013-06-01 23:58:44 +00:00
userinput Improve the dialog(1) API in dialog.subr by adding f_dialog_default_store() 2013-06-02 09:02:12 +00:00
usermgmt Standardize the way functions build their arguments leading up to a dialog 2013-06-02 20:02:50 +00:00