| @@ -1,14 +1,14 @@ | | | @@ -1,14 +1,14 @@ |
1 | .\" $NetBSD: sh.1,v 1.176 2018/03/13 19:18:53 uwe Exp $ | | 1 | .\" $NetBSD: sh.1,v 1.177 2018/03/13 19:35:46 uwe Exp $ |
2 | .\" Copyright (c) 1991, 1993 | | 2 | .\" Copyright (c) 1991, 1993 |
3 | .\" The Regents of the University of California. All rights reserved. | | 3 | .\" The Regents of the University of California. All rights reserved. |
4 | .\" | | 4 | .\" |
5 | .\" This code is derived from software contributed to Berkeley by | | 5 | .\" This code is derived from software contributed to Berkeley by |
6 | .\" Kenneth Almquist. | | 6 | .\" Kenneth Almquist. |
7 | .\" | | 7 | .\" |
8 | .\" Redistribution and use in source and binary forms, with or without | | 8 | .\" Redistribution and use in source and binary forms, with or without |
9 | .\" modification, are permitted provided that the following conditions | | 9 | .\" modification, are permitted provided that the following conditions |
10 | .\" are met: | | 10 | .\" are met: |
11 | .\" 1. Redistributions of source code must retain the above copyright | | 11 | .\" 1. Redistributions of source code must retain the above copyright |
12 | .\" notice, this list of conditions and the following disclaimer. | | 12 | .\" notice, this list of conditions and the following disclaimer. |
13 | .\" 2. Redistributions in binary form must reproduce the above copyright | | 13 | .\" 2. Redistributions in binary form must reproduce the above copyright |
14 | .\" notice, this list of conditions and the following disclaimer in the | | 14 | .\" notice, this list of conditions and the following disclaimer in the |
| @@ -432,27 +432,27 @@ if it has been set). | | | @@ -432,27 +432,27 @@ if it has been set). |
432 | .Sx Command Line Editing | | 432 | .Sx Command Line Editing |
433 | section below.) | | 433 | section below.) |
434 | .It Fl v Em verbose | | 434 | .It Fl v Em verbose |
435 | The shell writes its input to standard error as it is read. | | 435 | The shell writes its input to standard error as it is read. |
436 | Useful for debugging. | | 436 | Useful for debugging. |
437 | .It Fl X Em Xtrace | | 437 | .It Fl X Em Xtrace |
438 | Cause output from the | | 438 | Cause output from the |
439 | .Ic xtrace | | 439 | .Ic xtrace |
440 | .Pq Fl x | | 440 | .Pq Fl x |
441 | option to be sent to standard error as it exists when the | | 441 | option to be sent to standard error as it exists when the |
442 | .Fl X | | 442 | .Fl X |
443 | option is enabled (regardless of its previous state.) | | 443 | option is enabled (regardless of its previous state.) |
444 | For example: | | 444 | For example: |
445 | .Bd -compact -literal | | 445 | .Bd -literal -compact |
446 | set -X 2>/tmp/trace-file | | 446 | set -X 2>/tmp/trace-file |
447 | .Ed | | 447 | .Ed |
448 | will arrange for tracing output to be sent to the file named, | | 448 | will arrange for tracing output to be sent to the file named, |
449 | instead of wherever it was previously being sent, | | 449 | instead of wherever it was previously being sent, |
450 | until the X option is set again, or cleared. | | 450 | until the X option is set again, or cleared. |
451 | .Pp | | 451 | .Pp |
452 | Each change (set or clear) to | | 452 | Each change (set or clear) to |
453 | .Fl X | | 453 | .Fl X |
454 | is also performed upon | | 454 | is also performed upon |
455 | .Fl x , | | 455 | .Fl x , |
456 | but not the converse. | | 456 | but not the converse. |
457 | .It Fl x Em xtrace | | 457 | .It Fl x Em xtrace |
458 | Write each command to standard error (preceded by the expanded value of | | 458 | Write each command to standard error (preceded by the expanded value of |
| @@ -3517,27 +3517,27 @@ character. | | | @@ -3517,27 +3517,27 @@ character. |
3517 | If | | 3517 | If |
3518 | .Ev PSlit | | 3518 | .Ev PSlit |
3519 | is unset, which is its initial state, or set to a null string, | | 3519 | is unset, which is its initial state, or set to a null string, |
3520 | no literal character will be defined, | | 3520 | no literal character will be defined, |
3521 | and all characters of the prompt strings will be assumed | | 3521 | and all characters of the prompt strings will be assumed |
3522 | to be visible characters (which includes spaces etc.) | | 3522 | to be visible characters (which includes spaces etc.) |
3523 | To allow smooth use of prompts, without needing redefinition, when | | 3523 | To allow smooth use of prompts, without needing redefinition, when |
3524 | .Xr editline 7 | | 3524 | .Xr editline 7 |
3525 | is disabled, the character chosen should be one which will be | | 3525 | is disabled, the character chosen should be one which will be |
3526 | ignored by the terminal if received, as when | | 3526 | ignored by the terminal if received, as when |
3527 | .Xr editline 7 | | 3527 | .Xr editline 7 |
3528 | is not in use, the prompt strings are simply written to the terminal. | | 3528 | is not in use, the prompt strings are simply written to the terminal. |
3529 | For example, setting: | | 3529 | For example, setting: |
3530 | .Bd -compact -literal -offset left | | 3530 | .Bd -literal -offset left -compact |
3531 | PSlit="$(printf\ '\e1')" | | 3531 | PSlit="$(printf\ '\e1')" |
3532 | PS1="${PSlit}$(tput\ bold\ blink)${PSlit}\e$${PSlit}$(tput\ sgr0)${PSlit}\ " | | 3532 | PS1="${PSlit}$(tput\ bold\ blink)${PSlit}\e$${PSlit}$(tput\ sgr0)${PSlit}\ " |
3533 | .Ed | | 3533 | .Ed |
3534 | will arrange for the primary prompt to be a bold blinking dollar sign, | | 3534 | will arrange for the primary prompt to be a bold blinking dollar sign, |
3535 | if supported by the current terminal, followed by an (ordinary) space, | | 3535 | if supported by the current terminal, followed by an (ordinary) space, |
3536 | and, as the SOH (Control-A) character ('\e1') will not normally affect | | 3536 | and, as the SOH (Control-A) character ('\e1') will not normally affect |
3537 | a terminal, this same prompt will usually work with | | 3537 | a terminal, this same prompt will usually work with |
3538 | .Xr editline 7 | | 3538 | .Xr editline 7 |
3539 | enabled or disabled. | | 3539 | enabled or disabled. |
3540 | .Sh ENVIRONMENT | | 3540 | .Sh ENVIRONMENT |
3541 | .Bl -tag -width MAILCHECK | | 3541 | .Bl -tag -width MAILCHECK |
3542 | .It Ev CDPATH | | 3542 | .It Ev CDPATH |
3543 | The search path used with the | | 3543 | The search path used with the |