diff --git a/doc/terminator_config.adoc b/doc/terminator_config.adoc index db6b42a2..2f29fe6f 100644 --- a/doc/terminator_config.adoc +++ b/doc/terminator_config.adoc @@ -2,7 +2,7 @@ :doctype: manpage :manmanual: Manual for Terminator :mansource: Terminator -:revdate: 2023-04-03 +:revdate: 2023-04-07 :docdate: {revdate} == NAME @@ -41,6 +41,8 @@ This is what a Terminator config file should look like: custom_command = "echo \"foo#bar\"" #Final comment - this will work as expected. ---- +// ================================================================== \\ + == global_config These are the options Terminator currently supports in the *global_config* section. @@ -236,12 +238,315 @@ Specify which plugins will be loaded by default. All other plugin classes will be ignored. + Default value: *['LaunchpadBugURLHandler', 'LaunchpadCodeURLHandler', 'APTURLHandler']* +// ================================================================== \\ + == keybindings These are the options Terminator currently supports in the *keybindings* section. +=== Creation & Destruction + +*split_horiz*:: +Split the current terminal horizontally. + +Default value: *O* + +*split_vert*:: +Split the current terminal vertically. + +Default value: *E* + +*split_auto*:: +Split the current terminal automatically, along the longer side. + +Default value: *A* + +*new_tab*:: +Open a new tab. + +Default value: *T* + +*new_window*:: +Open a new window as part of the existing process. + +Default value: *I* + +*new_terminator*:: +Spawn a new Terminator process. + +Default value: *I* + +*layout_launcher*:: +Open the layout launcher. + +Default value: *L* + +*close_term*:: +Close the current terminal. + +Default value: *W* + +*close_window*:: +Close the current window. + +Default value: *Q* + +=== Navigation + +*cycle_next*:: +Focus the next terminal. This is an alias for *go_next*. + +Default value: *Tab* + +*cycle_prev*:: +Focus the previous terminal. This is an alias for *go_prev*. + +Default value: *Tab* + +*go_next*:: +Focus the next terminal. + +Default value: *N* + +*go_prev*:: +Focus the previous terminal. + +Default value: *P* + +*go_up*:: +Focus the terminal above the current one. + +Default value: *Up* + +*go_down*:: +Focus the terminal below the current one. + +Default value: *Down* + +*go_left*:: +Focus the terminal to the left of the current one. + +Default value: *Left* + +*go_right*:: +Focus the terminal to the right of the current one. + +Default value: *Right* + +// --- Scroll --- + +*page_up*:: +Scroll the terminal up one page. + +*page_down*:: +Scroll the terminal down one page. + +*page_up_half*:: +Scroll the terminal up half a page. + +*page_down_half*:: +Scroll the terminal down half a page. + +*line_up*:: +Scroll the terminal up one line. + +*line_down*:: +Scroll the terminal down one line. + +// --- Tab --- + +*next_tab*:: +Move to the next tab. + +Default value: *Page_Down* + +*prev_tab*:: +Move to the previous tab. + +Default value: *Page_Up* + +*switch_to_tab_1*, *switch_to_tab_2*, ... *switch_to_tab_10*:: +Move to the **N**th tab. +TODO note on switch_to_tab_1? + +=== Organisation + +*resize_up*:: +Move the parent dragbar up. + +Default value: *Up* + +*resize_down*:: +Move the parent dragbar down. + +Default value: *Down* + +*resize_left*:: +Move the parent dragbar left. + +Default value: *Left* + +*resize_right*:: +Move the parent dragbar right. + +Default value: *Right* + +*rotate_cw*:: +Rotate terminals clockwise. + +Default value: *R* + +*rotate_ccw*:: +Rotate terminals counter+clockwise. + +Default value: *R* + +*move_tab_right*:: +Move the current tab to the right by swapping position with the next +tab. + +Default value: *Page_Down* + +*move_tab_left*:: +Move the current tab to the left by swapping position with the previous +tab. + +Default value: *Page_Up* + +=== Focus + +*full_screen*:: +Toggle window to fullscreen. + +Default value: *F11* + +*toggle_zoom*:: +Toggle maximisation of the current terminal. + +Default value: *X* + +*scaled_zoom*:: +Toggle maximisation of the current terminal and scale the font when +maximised. + +Default value: *Z* + +*hide_window*:: +TODO + +Default value: *A* + +=== Grouping & Broadcasting + +*create_group*:: +Create a new group. + +// --- Grouping: All --- + +*group_all*:: +Group all terminals together. + +Default value: *G* + +*ungroup_all*:: +Ungroup all terminals. + +*group_all_toggle*:: +Toggle grouping of all terminals. + +// --- Grouping: Window --- + +*group_win*:: +Group all terminals in the current window together. + +*ungroup_win*:: +Ungroup all terminals in the current window. + +Default value: *W* + +*group_win_toggle*:: +Toggle grouping of all terminals in the current window. + +// --- Grouping: Tab --- + +*group_tab*:: +Group all terminals in the current tab together. + +Default value: *T* + +*ungroup_tab*:: +Ungroup all terminals in the current tab. + +Default value: *T* + +*group_tab_toggle*:: +Toggle grouping of all terminals in the current tab. + +// Broadcasting + +*broadcast_off*:: +Turn broadcasting off. + +*broadcast_group*:: +Broadcast to all terminals in the same group as the current terminal. + +*broadcast_all*:: +Broadcast to all terminals. + +=== Miscellaneous + +*help*:: +Open the full HTML manual in the browser. + +Default value: *F1* + +*preferences*:: +Open the Preferences window. + +*preferences_keybindings*:: +Open the Preferences window and show the Keybindings tab. + +Default value: *K* + +*copy*:: +Copy the selected text to the clipboard. + +Default value: *C* + +*paste*:: +Paste the current contents of the clipboard. + +Default value: *V* + +*paste_selection*:: TODO +*toggle_scrollbar*:: +Toggle the scrollbar. + +Default value: *S* + +*search*:: +Search for text in the terminal scrollback history. + +Default value: *F* + +*reset*:: +Reset the terminal state. + +Default value: *R* + +*reset_clear*:: +Reset the terminal state and clear the terminal window. + +Default value: *G* + +*zoom_in*:: +Increase the font size by one unit. + +Default value: *plus* + +*zoom_out*:: +Decrease the font size by one unit. + +Default value: *minus* + +*zoom_normal*:: +Restore the original font size. + +Default value: *0* + +*zoom_in_all*:: +Increase the font size by one unit for all terminals. + +*zoom_out_all*:: +Decrease the font size by one unit for all terminals. + +*zoom_normal_all*:: +Restore the original font size for all terminals. + +*edit_window_title*:: +Rename the current window. + +Default value: *W* + +*edit_tab_title*:: +Rename the current tab. + +Default value: *A* + +*edit_terminal_title*:: +Rename the current terminal. + +Default value: *X* + +*insert_number*:: +Insert the current terminal's number, i.e. 1 to 12. + +Default value: *1* + +*insert_padded*:: +Insert the current terminal's number, but zero padded, i.e. 01 to 12. + +Default value: *0* + +*next_profile*:: +Switch to the next profile. + +*previous_profile*:: +Switch to the previous profile. + +// ================================================================== \\ + == profiles These are the options Terminator currently supports in the *profiles* section. Each profile should be its own subsection with a header in the @@ -542,6 +847,11 @@ Specify the background color to use for the terminal's titlebar in case the terminal is in a group and is receiving input while unfocused. + Default value: *#0076c9* +// ================================================================== \\ + +TODO layouts section? +TODO plugins section? + == SEE ALSO *terminator*(1), http://www.voidspace.org.uk/python/configobj.html // this link might be dead