Skip to content

Commit

Permalink
fix #2
Browse files Browse the repository at this point in the history
  • Loading branch information
max-cx committed Dec 1, 2024
1 parent 20a3877 commit cdb9203
Show file tree
Hide file tree
Showing 32 changed files with 46 additions and 46 deletions.
14 changes: 7 additions & 7 deletions mkdocs/configure.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# Configuring XTerm

Expand All @@ -21,15 +21,15 @@ Before doing anything regarding the `~/.Xresources` dotfile, first check if you

!!! tip

The easiest way to start with a `~/.Xresources` dotfile is to download and use the [sample](https://github.com/xterm-x11/files.Xresources/blob/main/sample.Xresources) file (see instructions inside that file). Alternatively, you can run `$ touch ~/.Xresources` to create a blank one where you can add XTerm configuration lines.
The easiest way to start with a `~/.Xresources` dotfile is to download and use the [sample](https://github.com/xterm-x11/files.Xresources/blob/main/sample.Xresources) file (see instructions inside that file). Alternatively, you can run `$ touch ~/.Xresources` to create a blank one where you can add XTerm configuration lines.

## Checking the loaded X resources

Run `$ xrdb -query` to view the loaded X resources.

!!! tip

This command might be useful after editing the `~/.Xresources` dotfile.
This command might be useful after editing the `~/.Xresources` dotfile.

## Loading the X resources from the ~/.Xresources dotfile

Expand All @@ -55,13 +55,13 @@ You can reference another file in the `~/.Xresources` dotfile with an absolute p

* `.Xresources` are loaded into the X server, so are linked to a particular display environment.

"For most desktop environments, ~/.Xresources should be loaded at login. Note that if you make changes, you will need to run xrdb to pick them up. In my case, typically I care more about the server than the client for things like font size: for example, when using my laptop the resources are configured to suit a 14" screen at a particular resolution, and those same settings are used when I run xvile either locally, or remotely on my workstation over ssh. When sitting at my workstation which has a somewhat larger screen, I want different settings configured in the X server. By using .Xresources rather than .Xdefaults the same invocation of xvile behaves appropriately depending on where it is being displayed, rather than where was invoked from." [*Source*](https://lists.nongnu.org/archive/html/vile/2019-11/msg00002.html) "`.Xresources` works using `ssh -x`. I thought that my window manager would automatically load `.Xresources`, but it doesn't do so. Modifying my `.xinitrc` fixes the problem." [*Source*](https://lists.nongnu.org/archive/html/vile/2019-11/msg00004.html)
*"For most desktop environments, `~/.Xresources` should be loaded at login. Note that if you make changes, you will need to run `xrdb` to pick them up. In my case, typically I care more about the server than the client for things like font size: for example, when using my laptop the resources are configured to suit a 14" screen at a particular resolution, and those same settings are used when I run `xvile` either locally, or remotely on my workstation over `ssh`. When sitting at my workstation which has a somewhat larger screen, I want different settings configured in the X server. By using `.Xresources` rather than `.Xdefaults` the same invocation of `xvile` behaves appropriately depending on where it is being displayed, rather than where was invoked from."* [*Source*](https://lists.nongnu.org/archive/html/vile/2019-11/msg00002.html) *"`.Xresources` works using `ssh -x`. I thought that my window manager would automatically load `.Xresources`, but it doesn't do so. Modifying my `.xinitrc` fixes the problem."* [*Source*](https://lists.nongnu.org/archive/html/vile/2019-11/msg00004.html)

* `.Xdefaults` are set based on the client.

### .Xdefaults-*host* and XENVIRONMENT

"On POSIX-based systems, the user's environment resource file name is specified by the value of the `XENVIRONMENT` Environment Variable. If this environment variable does not exist, the user's home directory is searched for a file named `.Xdefaults-<host>`, where `<host>` is the host name of the machine on which the application is running." [*Source*](https://www.x.org/releases/X11R7.7/doc/libXt/intrinsics.html)
*"On POSIX-based systems, the user's environment resource file name is specified by the value of the `XENVIRONMENT` Environment Variable. If this environment variable does not exist, the user's home directory is searched for a file named `.Xdefaults-<host>`, where `<host>` is the host name of the machine on which the application is running."* [*Source*](https://www.x.org/releases/X11R7.7/doc/libXt/intrinsics.html)

### XAPPLRESDIR

Expand Down Expand Up @@ -90,8 +90,8 @@ Run `$ xrdb -help` or see the [xrdb](https://www.x.org/releases/X11R7.7/doc/man/

!!! warning

Running some of the `xrdb` options interferes with dynamic loading of X resources by applications.
Running some of the `xrdb` options interferes with dynamic loading of X resources by applications.

!!! warning

If you decide to use `$ xrdb -remove`, be aware that it clears **(!)** *all* previously loaded X resources, including the X resources that were loaded at login.
If you decide to use `$ xrdb -remove`, be aware that it clears **(!)** *all* previously loaded X resources, including the X resources that were loaded at login.
14 changes: 7 additions & 7 deletions mkdocs/copy-and-paste.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ author: Max Leonov

!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# Copy and paste

Expand All @@ -16,7 +16,7 @@ You can easily select text in an XTerm window as you would expect in another app

!!! tip

XTerm's X resources enable you to configure how much of text you wish to get selected on multiple clicks, adjust the clicking speed (as time interval) for multiple clicks, include or exclude the new line, and more. For more information, see [Configure](configure.md) and [Customize copy and paste](customize-copy-and-paste.md).
XTerm's X resources enable you to configure how much of text you wish to get selected on multiple clicks, adjust the clicking speed (as time interval) for multiple clicks, include or exclude the new line, and more. For more information, see [Configure](configure.md) and [Customize copy and paste](customize-copy-and-paste.md).

With a mouse or trackball that has a scroll wheel, you can extend your initial selection beyond the visible screen in an XTerm window:

Expand All @@ -39,24 +39,24 @@ By default, XTerm automatically copies every text selection you make in an XTerm

!!! warning

Unconfigured XTerm copies text to the PRIMARY buffer rather than CLIPBOARD that most applications use nowadays. Unless you prefer or need to use the PRIMARY buffer on purpose, it's best that you configure XTerm to copy all text to CLIPBOARD instead. To do that, all you need to do is add the `XTerm.vt100.selectToClipboard: true` X resource to your dotfile (this is already `true` in [sample.Xresources](https://github.com/xterm-x11/files.Xresources/blob/main/sample.Xresources)). For more information, see [Configure](configure.md) and [Customize copy and paste](customize-copy-and-paste.md).
Unconfigured XTerm copies text to the PRIMARY buffer rather than CLIPBOARD that most applications use nowadays. Unless you prefer or need to use the PRIMARY buffer on purpose, it's best that you configure XTerm to copy all text to CLIPBOARD instead. To do that, all you need to do is add the `XTerm.vt100.selectToClipboard: true` X resource to your dotfile (this is already `true` in [sample.Xresources](https://github.com/xterm-x11/files.Xresources/blob/main/sample.Xresources)). For more information, see [Configure](configure.md) and [Customize copy and paste](customize-copy-and-paste.md).

!!! tip

You can configure XTerm to work with a keyboard shortcut to copy text if you can't get used to the convenience of not having to press any keys to copy. For how to set a custom keyboard shortcut, see [Configure](configure.md) and [Customize copy and paste](customize-copy-and-paste.md).
You can configure XTerm to work with a keyboard shortcut to copy text if you can't get used to the convenience of not having to press any keys to copy. For how to set a custom keyboard shortcut, see [Configure](configure.md) and [Customize copy and paste](customize-copy-and-paste.md).

## Pasting text in XTerm

By default, to paste copied text into an XTerm window, use the **Shift+Insert** keyboard shortcut or the middle mouse button (if your mouse or trackpad has one).

!!! tip

Depending on your system, you should be able to use the **Shift+Insert** keyboard shortcut for pasting text copied from an XTerm window into other applications (like **Ctrl+V**). If you stick with using the **Shift+Insert** keyboard shortcut in XTerm, it's easier to remember and more convenient to use this same shortcut every time you paste text copied to or from XTerm.
Depending on your system, you should be able to use the **Shift+Insert** keyboard shortcut for pasting text copied from an XTerm window into other applications (like **Ctrl+V**). If you stick with using the **Shift+Insert** keyboard shortcut in XTerm, it's easier to remember and more convenient to use this same shortcut every time you paste text copied to or from XTerm.

!!! tip

You can set a custom keyboard shortcut for pasting selected text. For how to do that, see [Configure](configure.md) and [Customize copy and paste](customize-copy-and-paste.md). This is useful in some situations such as when the keyboard you're using doesn't have a dedicated **Insert** button, making it difficult to press **Shift+Insert**.
You can set a custom keyboard shortcut for pasting selected text. For how to do that, see [Configure](configure.md) and [Customize copy and paste](customize-copy-and-paste.md). This is useful in some situations such as when the keyboard you're using doesn't have a dedicated **Insert** button, making it difficult to press **Shift+Insert**.

!!! tip

If your hardware doesn't have the middle mouse button, you might be able to set up emulation to use both the left and right mouse buttons instead of the middle mouse button.
If your hardware doesn't have the middle mouse button, you might be able to set up emulation to use both the left and right mouse buttons instead of the middle mouse button.
2 changes: 1 addition & 1 deletion mkdocs/ctlseqs-guide.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# Guide to control sequences

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/ctlseqs-list.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# List of control sequences

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/fonts.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

<!--- issue 91 --->

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/full-screen.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# Full-screen

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/getting-started-with-ctlseqs.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# Getting started with control sequences

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/history.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# TBD, The XTerm story

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/icon.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# XTerm icon

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# XTerm

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/keyboard-shortcuts.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# Keyboard shortcuts for XTerm

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/luit-archives.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# Luit archives

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/luit.tar.gz.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# luit.tar.gz

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/manual-window-title.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# Manual window title

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/ncurses-examples-about.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

<!--- issue 89 --->

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/ncurses.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# NCURSES

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/package.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@

!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# Quick install on Linux

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/prompt.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# Prompt

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/recommended-tools.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

<!--- issue ?? --->

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/sample.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# .Xresources sample file

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/scripts.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

<!--- issue 90 --->

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/scrollbar.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# Scrollbar

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/scrolling.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# Scrolling

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/static-window-title.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# Static window title

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/tabs.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# Tabs

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/template.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# .Xresources template file

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/themes.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# Themes

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/vttest-archives.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# Vttest archives

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/vttest.tar.gz.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# vttest.tar.gz

Expand Down
6 changes: 3 additions & 3 deletions mkdocs/window-properties.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
!!! tip

The X resources mentioned on this page are included in both the [template `.Xresouces` file](https://github.com/xterm-x11/files.Xresources/blob/main/template.Xresources) and the [sample `.Xresources` file](https://github.com/xterm-x11/files.Xresources/blob/main/sample.Xresources).
The X resources mentioned on this page are included in both the [template `.Xresouces` file](https://github.com/xterm-x11/files.Xresources/blob/main/template.Xresources) and the [sample `.Xresources` file](https://github.com/xterm-x11/files.Xresources/blob/main/sample.Xresources).

!!! note

You can also use XTerm's command-line options as an alternative to the .Xresources file when needed.
You can also use XTerm's command-line options as an alternative to the .Xresources file when needed.

# XTerm window properties

Expand Down Expand Up @@ -40,7 +40,7 @@ xterm*borderColor: green

!!! note

On some window managers, the window internal border might appear thicker in pixels when set to the default (`2` pixels) or minimal (`1` pixel) width values. XTerm sets window-manager hints such as to tell the window manager to do resizing in units that correspond to the font size or that the minimal window size is equal to the inner border (`2` when the border is set to `1`), but the hints and negotiation might not be correctly implemented in some window managers.
On some window managers, the window internal border might appear thicker in pixels when set to the default (`2` pixels) or minimal (`1` pixel) width values. XTerm sets window-manager hints such as to tell the window manager to do resizing in units that correspond to the font size or that the minimal window size is equal to the inner border (`2` when the border is set to `1`), but the hints and negotiation might not be correctly implemented in some window managers.

## Configuring the default window size

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/xterm.tar.gz.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# xterm.tar.gz

Expand Down
2 changes: 1 addition & 1 deletion mkdocs/xtoolkit.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
!!! tip

You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).
You can read this website in a terminal by installing and running [Lynx](https://lynx.browser.org/).

# Xtoolkit

Expand Down

0 comments on commit cdb9203

Please sign in to comment.