comparison share/man/man1/roundup-admin.1 @ 7795:d7d68da9878f

save roundup-admin history between sessions. Also load ~/.roundup_admin_rlrc (rlrc readline run commands) file to set history-size persistently, allow user to use vi mode etc.
author John Rouillard <rouilj@ieee.org>
date Sun, 10 Mar 2024 13:44:13 -0400
parents 73dfa9df9fb0
children 8bdf0484215c
comparison
equal deleted inserted replaced
7794:1632bdbfbef6 7795:d7d68da9878f
289 merged/updated config file is written to \fI<filename>\fP. 289 merged/updated config file is written to \fI<filename>\fP.
290 .PP 290 .PP
291 Commands may be abbreviated as long as the abbreviation 291 Commands may be abbreviated as long as the abbreviation
292 matches only one command, e.g. l == li == lis == list. 292 matches only one command, e.g. l == li == lis == list.
293 293
294 .SH READLINE SUPPORT
295
296 You can edit the command line and interact with history in
297 roundup-admin's interactive mode. On Linux like systems, GNU Readline
298 is required. On Mac's libedit can be used as well. On Windows
299 pyreadline3 is required. See:
300 https://docs.python.org/3/library/readline.html for details on
301 readline.
302
303 Roundup-admin will save the history between roundup-admin
304 sessions. The commands are saved to the \fB.roundup_admin_history\fP
305 file in the user's home directory. You can set the pragma
306 \fBhistory_length\fP on the roundup-admin command line to change the
307 amount of available and stored history for the session.
308
309 If you are using GNU readline, you can persistently change the history
310 size by adding: \fBset history-size 100\fP to the init file
311 \fB.roundup_admin_rlrc\fP located in the user's home directory.
312
313 Mac users using libedit should be able to persistently save history
314 and set the history size by adding \fBhistory size 100\fP.
315
316 Users of pyreadline3 can use: \fBhistory_length(100)\fP.
317
294 .SH SECURITY NOTES 318 .SH SECURITY NOTES
295 319
296 The \fB-u user\fP setting does not currently operate like a 320 The \fB-u user\fP setting does not currently operate like a
297 user logging in via the web. The user running roundup-admin 321 user logging in via the web. The user running roundup-admin
298 must have read access to the tracker home directory. As a 322 must have read access to the tracker home directory. As a

Roundup Issue Tracker: http://roundup-tracker.org/