Print this page
12212 typos in some section 3tecla man pages
*** 305,315 ****
returned GLTO_ABORT. See gl_inactivity_timeout() for
information about timeouts.
GLR_FDABORT
! An application I/O callback returned GLFD_ABORT. Ssee
gl_watch_fd().
GLR_EOF
End of file reached. This can happen when input is
--- 305,315 ----
returned GLTO_ABORT. See gl_inactivity_timeout() for
information about timeouts.
GLR_FDABORT
! An application I/O callback returned GLFD_ABORT. See
gl_watch_fd().
GLR_EOF
End of file reached. This can happen when input is
*** 475,487 ****
use of the terminal bell by the library. It then attempts to read
system-wide configuration commands from an optional file called
/usr/share/myapp/teclarc, then finally reads user-specific
configuration commands from an optional .teclarc file in the user's
home directory. Note that the arguments are listed in ascending order
! of priority, with the contents of app_string being potentially over
! riden by commands in app_file, and commands in app_file potentially
! being overridden by commands in user_file.
You can call this function as many times as needed, the results being
cumulative, but note that copies of any file names specified with the
app_file and user_file arguments are recorded internally for subsequent
--- 475,487 ----
use of the terminal bell by the library. It then attempts to read
system-wide configuration commands from an optional file called
/usr/share/myapp/teclarc, then finally reads user-specific
configuration commands from an optional .teclarc file in the user's
home directory. Note that the arguments are listed in ascending order
! of priority, with the contents of app_string being potentially
! overridden by commands in app_file, and commands in app_file
! potentially being overridden by commands in user_file.
You can call this function as many times as needed, the results being
cumulative, but note that copies of any file names specified with the
app_file and user_file arguments are recorded internally for subsequent
*** 542,560 ****
the word being completed. It then must lookup possible completions of
this word, and record them one by one in the WordCompletion object that
is passed to it as an argument, by calling the cpl_add_completion()
function. If the callback function wants to provide filename completion
in addition to its own specific completions, it has the option of
! itself calling the builtin filename completion callback. This also is
! documented on the cpl_complete_word(3TECLA) manual page.
If you would like gl_get_line() to return the current input line when a
! successful completion is been made, you can arrange this when you call
cpl_add_completion() by making the last character of the continuation
suffix a newline character. The input line will be updated to display
! the completion, together with any contiuation suffix up to the newline
character, and gl_get_line() will return this input line.
If your callback function needs to write something to the terminal, it
must call gl_normal_io() before doing so. This will start a new line
--- 542,560 ----
the word being completed. It then must lookup possible completions of
this word, and record them one by one in the WordCompletion object that
is passed to it as an argument, by calling the cpl_add_completion()
function. If the callback function wants to provide filename completion
in addition to its own specific completions, it has the option of
! itself calling the builtin filename completion callback. This is also
! documented in the cpl_complete_word(3TECLA) manual page.
If you would like gl_get_line() to return the current input line when a
! successful completion has been made, you can arrange this when you call
cpl_add_completion() by making the last character of the continuation
suffix a newline character. The input line will be updated to display
! the completion, together with any continuation suffix up to the newline
character, and gl_get_line() will return this input line.
If your callback function needs to write something to the terminal, it
must call gl_normal_io() before doing so. This will start a new line
*** 587,603 ****
specifies the default key sequence to bind the action to. If this is
NULL, no new key sequence will be bound to the action.
Beware that in order for the user to be able to change the key sequence
! that is bound to actions that are installed in this manner, you
! shouldcall gl_completion_action() to install a given action for the
! first time between calling new_GetLine() and the first call to
! gl_get_line(). Otherwise, when the user's configuration file is read
! on the first call to gl_get_line(), the name of the your additional
! action will not be known, and any reference to it in the configuration
! file will generate an error.
As discussed for gl_customize_completion(), if your callback function
needs to write anything to the terminal, it must call gl_normal_io()
before doing so.
--- 587,603 ----
specifies the default key sequence to bind the action to. If this is
NULL, no new key sequence will be bound to the action.
Beware that in order for the user to be able to change the key sequence
! that is bound to actions that are installed in this manner, you should
! call gl_completion_action() to install a given action for the first
! time between calling new_GetLine() and the first call to gl_get_line().
! Otherwise, when the user's configuration file is read on the first call
! to gl_get_line(), the name of the your additional action will not be
! known, and any reference to it in the configuration file will generate
! an error.
As discussed for gl_customize_completion(), if your callback function
needs to write anything to the terminal, it must call gl_normal_io()
before doing so.
*** 738,748 ****
The max_lines argument must be either -1 to specify that all lines in
the history list be saved, or a positive number specifying a ceiling on
how many of the most recent lines should be saved.
! Both fuctions return non-zero on error, after writing an error message
to stderr. Note that gl_load_history() does not consider the non-
existence of a file to be an error.
Multiple History Lists
If your application uses a single GetLine object for entering many
--- 738,748 ----
The max_lines argument must be either -1 to specify that all lines in
the history list be saved, or a positive number specifying a ceiling on
how many of the most recent lines should be saved.
! Both functions return non-zero on error, after writing an error message
to stderr. Note that gl_load_history() does not consider the non-
existence of a file to be an error.
Multiple History Lists
If your application uses a single GetLine object for entering many
*** 1434,1444 ****
terminal line of a longer input line, this will have the same effect as
GL_SUSPEND_INPUT. Otherwise it will start writing on a line that
already contains part of the displayed input line. This does not do any
harm, but it looks a bit ugly, which is why the GL_SUSPEND_INPUT
combination is better if you know that you are always going to be
! writting to the terminal.
The after argument, which determines what gl_get_line() does after the
application's signal handler returns (if it returns), can take any one
of the following values:
--- 1434,1444 ----
terminal line of a longer input line, this will have the same effect as
GL_SUSPEND_INPUT. Otherwise it will start writing on a line that
already contains part of the displayed input line. This does not do any
harm, but it looks a bit ugly, which is why the GL_SUSPEND_INPUT
combination is better if you know that you are always going to be
! writing to the terminal.
The after argument, which determines what gl_get_line() does after the
application's signal handler returns (if it returns), can take any one
of the following values:
*** 1907,1912 ****
cpl_complete_word(3TECLA), ef_expand_file(3TECLA), gl_io_mode(3TECLA),
libtecla(3LIB), pca_lookup_file(3TECLA), attributes(5), tecla(5)
! April 9, 2016 GL_GET_LINE(3TECLA)
--- 1907,1912 ----
cpl_complete_word(3TECLA), ef_expand_file(3TECLA), gl_io_mode(3TECLA),
libtecla(3LIB), pca_lookup_file(3TECLA), attributes(5), tecla(5)
! January 18, 2020 GL_GET_LINE(3TECLA)