mirror of
https://github.com/lcn2/calc.git
synced 2025-08-16 01:03:29 +03:00
54dd89dcf7
Documented unexpected behavior when calc is running in "shell script mode" and the prompt builtin function is used without the -p flag. Updated help/prompt, help/unexpected and the calc man page accordingly. Unless calc is given the -p command line option, calc will reopen stdin as /dev/null instead of just closing stdin. This prevents subsequent opens grabbing the 1st file descriptor. Disable regress tests 4709, 4710, and 7763 because they print multi-byte sequences, which are just fine for calc, the awk used to evaluate the regression suite output in some legacy systems report a "multibyte conversion failure". Added a number of missing Makefile variables to the "make env" rule. The man command is used to format the calc.1 man page into calc.usage. The "help calc" command now prints the formatted calc man page (calc.usage). The "help man" command now prints the formatted calc man page (calc.usage). The "help usage" command now prints the formatted calc man page (calc.usage). The file, calc.cat1, is formed by gzipping the calc.usage formatted man page. The calc.cat1 is installed as the calc cat section 1 man page. Updated the Copyright string in version.c to refer to the COPYING file and the "help copying" command. Added calc.cat1 to .gitignore. Using "sort -d -u" to sort .gitignore content. Avoiding use of modern [[ and ]] in Makefile for those legacy systems whose shell do not support them. *sigh* Fixed the order of "help full" to match the order of topics listed buy the "help help" command. Sorted the halias[] help topics table in help.c using sort -d -u.
94 lines
2.6 KiB
Plaintext
94 lines
2.6 KiB
Plaintext
NAME
|
|
prompt - display a prompt and wait for input from terminal
|
|
|
|
SYNOPSIS
|
|
prompt(str)
|
|
|
|
TYPES
|
|
str string
|
|
|
|
return string
|
|
|
|
DESCRIPTION
|
|
When prompt(str) is called and input is from a terminal, the string
|
|
str is displayed and execution is halted until a newline ends a line
|
|
read from the input; the string formed by the characters in the line
|
|
(other than the newline) is returned as the value of prompt().
|
|
|
|
Be careful when using prompt(str) while calc is being used as a
|
|
shell script. Unless calc is run with the -p command line option,
|
|
the prompt builtin will fail and return null. This is because when
|
|
calc is running as a shell script, calc will close stdin run in in
|
|
a non-interactive mode.
|
|
|
|
The following shell script will always print "got null" because
|
|
stdin will be closed by calc during startup:
|
|
|
|
#!/usr/bin/calc -q -f
|
|
|
|
# The prompt will ALWAYS FAIL and return a null value
|
|
n = prompt("Test> ");
|
|
if (isnull(n)) {
|
|
print("got null");
|
|
} else {
|
|
print("got " + n);
|
|
}
|
|
|
|
However the following shell script (note the -p before the -f in
|
|
the 1st line) will be interactive, prompt with "Test> " and print
|
|
the "got" result as expected:
|
|
|
|
#!/usr/bin/calc -q -p -f
|
|
|
|
n = prompt("Test> ");
|
|
if (isnull(n)) {
|
|
print("got null");
|
|
} else {
|
|
print("got " + n);
|
|
}
|
|
|
|
|
|
EXAMPLE
|
|
; x = prompt("? ");
|
|
? 273
|
|
; x
|
|
"273"
|
|
|
|
; for (;;) {s = prompt("? "); if (s=="end") break; print "\t":eval(s)^2;}
|
|
? 3
|
|
9
|
|
? 2 + 3
|
|
25
|
|
? end
|
|
|
|
LIMITS
|
|
none
|
|
|
|
LINK LIBRARY
|
|
none
|
|
|
|
SEE ALSO
|
|
command, fgetfield, fgetline, fgetstr, unexpected
|
|
|
|
## Copyright (C) 1999,2023 Landon Curt Noll
|
|
##
|
|
## Calc is open software; you can redistribute it and/or modify it under
|
|
## the terms of the version 2.1 of the GNU Lesser General Public License
|
|
## as published by the Free Software Foundation.
|
|
##
|
|
## Calc is distributed in the hope that it will be useful, but WITHOUT
|
|
## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
|
|
## or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
|
|
## Public License for more details.
|
|
##
|
|
## A copy of version 2.1 of the GNU Lesser General Public License is
|
|
## distributed with calc under the filename COPYING-LGPL. You should have
|
|
## received a copy with calc; if not, write to Free Software Foundation, Inc.
|
|
## 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
##
|
|
## Under source code control: 1995/12/18 12:34:58
|
|
## File existed as early as: 1995
|
|
##
|
|
## chongo <was here> /\oo/\ http://www.isthe.com/chongo/
|
|
## Share and enjoy! :-) http://www.isthe.com/chongo/tech/comp/calc/
|