xenia/kakoune
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Merge remote-tracking branch 'Delapouite/sync-exit-status'

Browse Source
This commit is contained in:
Maxime Coste 2018-09-03 22:33:20 +10:00
commit b581a4fbed
2 changed files with 34 additions and 34 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
doc/pages/commands.asciidoc
View File

@ -11,6 +11,9 @@ command *q!* has to be used). Aliases are mentionned below each commands.
== Files and Buffers == Files and Buffers
For the following *write* commands, the *-sync* switch forces the synchronization
of the file onto the filesystem
*change-directory* [<directory>]:: *change-directory* [<directory>]::
*alias* cd + *alias* cd +
change the current directory to *directory*, or the home directory if change the current directory to *directory*, or the home directory if
@ -21,14 +24,14 @@ command *q!* has to be used). Aliases are mentionned below each commands.
open buffer on file, go to given line and column. If file is already open buffer on file, go to given line and column. If file is already
opened, just switch to this file. Use edit! to force reloading opened, just switch to this file. Use edit! to force reloading
*write[!]* [<filename>]:: *write[!]* [-sync] [<filename>]::
*alias* w + *alias* w +
write buffer to <filename> or use its name if filename is not write buffer to <filename> or use its name if filename is not
given. If the file is write-protected, its permissions are temporarily given. If the file is write-protected, its permissions are temporarily
changed to allow saving the buffer and restored afterwards when changed to allow saving the buffer and restored afterwards when
the write! command is used. the write! command is used.
*write-all*:: *write-all* [-sync]::
*alias* wa + *alias* wa +
write all buffers that are associated to a file write all buffers that are associated to a file
@ -38,12 +41,12 @@ command *q!* has to be used). Aliases are mentionned below each commands.
unsaved buffers remaining. If specified, the client exit status unsaved buffers remaining. If specified, the client exit status
will be set to <exit status> will be set to <exit status>
*write-quit[!]* [<exit status>]:: *write-quit[!]* [-sync] [<exit status>]::
*alias* wq + *alias* wq +
write current buffer and quit current client. If specified, the client write current buffer and quit current client. If specified, the client
exit status will be set to <exit status> exit status will be set to <exit status>
*write-all-quit* [<exit status>]:: *write-all-quit* [-sync] [<exit status>]::
*alias* waq + *alias* waq +
write all buffers and quit. If specified, the client exit status write all buffers and quit. If specified, the client exit status
will be set to <exit status> will be set to <exit status>
@ -62,7 +65,7 @@ command *q!* has to be used). Aliases are mentionned below each commands.
*delete-buffer[!]* [<name>]:: *delete-buffer[!]* [<name>]::
*alias* db + *alias* db +
delete the buffer <name> delete current buffer or the buffer <name> if specified
*rename-buffer* <name>:: *rename-buffer* <name>::
set current buffer name set current buffer name
@ -80,8 +83,9 @@ command *q!* has to be used). Aliases are mentionned below each commands.
*rename-session* <name>:: *rename-session* <name>::
set current session name set current session name
*kill[!]*:: *kill[!]* [<exit status>]::
terminate the current session, all the clients as well as the server terminate the current session, all the clients as well as the server.
If specified, the server and clients exit status will be set to <exit status>
== Options == Options

50
src/commands.cc
View File

@ -351,9 +351,8 @@ void write_buffer(const ParametersParser& parser, Context& context, const ShellC
const CommandDesc write_cmd = { const CommandDesc write_cmd = {
"write", "write",
"w", "w",
"write [-sync] [filename]: write the current buffer to its file " "write [-sync] [<filename>]: write the current buffer to its file "
"or to [filename] if specified; the underlying file can be " "or to <filename> if specified",
"synchronized with the filesystem with the -sync switch",
write_params, write_params,
CommandFlags::None, CommandFlags::None,
CommandHelper{}, CommandHelper{},
@ -364,9 +363,8 @@ const CommandDesc write_cmd = {
const CommandDesc force_write_cmd = { const CommandDesc force_write_cmd = {
"write!", "write!",
"w!", "w!",
"write [-sync] [filename]: write the current buffer to its file " "write! [-sync] [<filename>]: write the current buffer to its file "
"or to [filename] if specified, even when the file is write protected;" "or to <filename> if specified, even when the file is write protected",
"the underlying file can be synchronized with the filesystem with the -sync switch",
write_params, write_params,
CommandFlags::None, CommandFlags::None,
CommandHelper{}, CommandHelper{},
@ -398,8 +396,7 @@ void write_all_buffers(Context& context, bool sync = false)
const CommandDesc write_all_cmd = { const CommandDesc write_all_cmd = {
"write-all", "write-all",
"wa", "wa",
"write-all [-sync]: write all buffers that are associated to a file;" "write-all [-sync]: write all buffers that are associated to a file",
"all open files can be synchronized with the filesystem with the -sync switch",
ParameterDesc{ ParameterDesc{
{ { "sync", { false, "force the synchronization of the file onto the filesystem" } } }, { { "sync", { false, "force the synchronization of the file onto the filesystem" } } },
ParameterDesc::Flags::None, 0, 0 ParameterDesc::Flags::None, 0, 0
@ -452,8 +449,8 @@ void kill(const ParametersParser& parser, Context& context, const ShellContext&)
const CommandDesc kill_cmd = { const CommandDesc kill_cmd = {
"kill", "kill",
nullptr, nullptr,
"kill [exit_code]: terminate the current session, the server and all clients connected" "kill [<exit status>]: terminate the current session, the server and all clients connected. "
"; the given integer will be used as exit code by the server and client processes", "An optional integer parameter can set the server and client processes exit status",
{ {}, ParameterDesc::Flags::SwitchesAsPositional, 0, 1 }, { {}, ParameterDesc::Flags::SwitchesAsPositional, 0, 1 },
CommandFlags::None, CommandFlags::None,
CommandHelper{}, CommandHelper{},
@ -465,8 +462,8 @@ const CommandDesc kill_cmd = {
const CommandDesc force_kill_cmd = { const CommandDesc force_kill_cmd = {
"kill!", "kill!",
nullptr, nullptr,
"kill [exit_code]: force the termination of the current session, the server and all clients connected" "kill! [<exit status>]: force the termination of the current session, the server and all clients connected. "
"; the given integer will be used as exit code by the server and client processes", "An optional integer parameter can set the server and client processes exit status",
{ {}, ParameterDesc::Flags::SwitchesAsPositional, 0, 1 }, { {}, ParameterDesc::Flags::SwitchesAsPositional, 0, 1 },
CommandFlags::None, CommandFlags::None,
CommandHelper{}, CommandHelper{},
@ -487,9 +484,9 @@ void quit(const ParametersParser& parser, Context& context, const ShellContext&)
const CommandDesc quit_cmd = { const CommandDesc quit_cmd = {
"quit", "quit",
"q", "q",
"quit current client, and the kakoune session if the client is the last " "quit [<exit status>]: quit current client, and the kakoune session if the client is the last "
"(if not running in daemon mode). An optional integer parameter can set " "(if not running in daemon mode). "
"the client exit status", "An optional integer parameter can set the client exit status",
{ {}, ParameterDesc::Flags::SwitchesAsPositional, 0, 1 }, { {}, ParameterDesc::Flags::SwitchesAsPositional, 0, 1 },
CommandFlags::None, CommandFlags::None,
CommandHelper{}, CommandHelper{},
@ -500,10 +497,10 @@ const CommandDesc quit_cmd = {
const CommandDesc force_quit_cmd = { const CommandDesc force_quit_cmd = {
"quit!", "quit!",
"q!", "q!",
"quit current client, and the kakoune session if the client is the last " "quit! [<exit status>]: quit current client, and the kakoune session if the client is the last "
"(if not running in daemon mode). force quit even if the client is the " "(if not running in daemon mode). Force quit even if the client is the "
"last and some buffers are not saved. An optional integer parameter can " "last and some buffers are not saved. "
"set the client exit status", "An optional integer parameter can set the client exit status",
{ {}, ParameterDesc::Flags::SwitchesAsPositional, 0, 1 }, { {}, ParameterDesc::Flags::SwitchesAsPositional, 0, 1 },
CommandFlags::None, CommandFlags::None,
CommandHelper{}, CommandHelper{},
@ -522,8 +519,8 @@ void write_quit(const ParametersParser& parser, Context& context,
const CommandDesc write_quit_cmd = { const CommandDesc write_quit_cmd = {
"write-quit", "write-quit",
"wq", "wq",
"write-quit [-sync] [exit_code]: write current buffer and quit current client. An optional integer parameter can set the client exit status;" "write-quit [-sync] [<exit status>]: write current buffer and quit current client. "
"all open files can be synchronized with the filesystem with the -sync switch", "An optional integer parameter can set the client exit status",
write_params, write_params,
CommandFlags::None, CommandFlags::None,
CommandHelper{}, CommandHelper{},
@ -534,8 +531,8 @@ const CommandDesc write_quit_cmd = {
const CommandDesc force_write_quit_cmd = { const CommandDesc force_write_quit_cmd = {
"write-quit!", "write-quit!",
"wq!", "wq!",
"write current buffer and quit current client, even if other buffers are " "write-quit! [-sync] [<exit status>] write: current buffer and quit current client, even if other buffers are not saved. "
"not saved. An optional integer parameter can set the client exit status", "An optional integer parameter can set the client exit status",
write_params, write_params,
CommandFlags::None, CommandFlags::None,
CommandHelper{}, CommandHelper{},
@ -546,9 +543,8 @@ const CommandDesc force_write_quit_cmd = {
const CommandDesc write_all_quit_cmd = { const CommandDesc write_all_quit_cmd = {
"write-all-quit", "write-all-quit",
"waq", "waq",
"write-all-quit [-sync] [exit_code]: write all buffers associated to a file and quit current client." "write-all-quit [-sync] [<exit status>]: write all buffers associated to a file and quit current client. "
"An optional integer parameter can set the client exit status;" "An optional integer parameter can set the client exit status.",
"all open files can be synchronized with the filesystem with the -sync switch",
write_params, write_params,
CommandFlags::None, CommandFlags::None,
CommandHelper{}, CommandHelper{},
@ -1820,7 +1816,7 @@ struct CapturedShellContext
const CommandDesc prompt_cmd = { const CommandDesc prompt_cmd = {
"prompt", "prompt",
nullptr, nullptr,
"prompt <prompt> <command>: prompt the user to enter a text string " "prompt [<switches>] <prompt> <command>: prompt the user to enter a text string "
"and then executes <command>, entered text is available in the 'text' value", "and then executes <command>, entered text is available in the 'text' value",
ParameterDesc{ ParameterDesc{
{ { "init", { true, "set initial prompt content" } }, { { "init", { true, "set initial prompt content" } },