bin/ed/ed.1

   1 .\"     $NetBSD: ed.1,v 1.28 2003/09/08 13:13:08 wiz Exp $
   2 .\"     $OpenBSD: ed.1,v 1.42 2003/07/27 13:25:43 jmc Exp $
   3 .\"
   4 .\" Copyright (c) 1993 Andrew Moore, Talke Studio.
   5 .\" All rights reserved.
   6 .\"
   7 .\" Redistribution and use in source and binary forms, with or without
   8 .\" modification, are permitted provided that the following conditions
   9 .\" are met:
  10 .\" 1. Redistributions of source code must retain the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer.
  12 .\" 2. Redistributions in binary form must reproduce the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer in the
  14 .\"    documentation and/or other materials provided with the distribution.
  15 .\"
  16 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  17 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  19 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  20 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  22 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  24 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  26 .\" SUCH DAMAGE.
  27 .\"
  28 .Dd January 23, 2002
  29 .Dt ED 1
  30 .Os
  31 .Sh NAME
  32 .Nm ed
  33 .Nd text editor
  34 .Sh SYNOPSIS
  35 .Nm
  36 .Op Fl
  37 .Op Fl Esx
  38 .Op Fl p Ar string
  39 .Op Ar file
  40 .Sh DESCRIPTION
  41 .Nm
  42 is a line-oriented text editor.
  43 It is used to create, display, modify, and otherwise manipulate text files.
  44 If invoked with a
  45 .Ar file
  46 argument, then a copy of
  47 .Ar file
  48 is read into the editor's buffer.
  49 Changes are made to this copy and not directly to
  50 .Ar file
  51 itself.
  52 Upon quitting
  53 .Nm ,
  54 any changes not explicitly saved with a
  55 .Ic w
  56 command are lost.
  57 .Pp
  58 Editing is done in two distinct modes:
  59 .Em command
  60 and
  61 .Em input .
  62 When first invoked,
  63 .Nm
  64 is in command mode.
  65 In this mode, commands are read from the standard input and
  66 executed to manipulate the contents of the editor buffer.
  67 .Pp
  68 A typical command might look like:
  69 .Bd -literal -offset indent
  70 ,s/old/new/g
  71 .Ed
  72 .Pp
  73 which replaces all occurrences of the string
  74 .Pa old
  75 with
  76 .Pa new .
  77 .Pp
  78 When an input command, such as
  79 .Ic a
  80 (append),
  81 .Ic i
  82 (insert),
  83 or
  84 .Ic c
  85 (change) is given,
  86 .Nm
  87 enters input mode.
  88 This is the primary means of adding text to a file.
  89 In this mode, no commands are available;
  90 instead, the standard input is written directly to the editor buffer.
  91 Lines consist of text up to and including a newline character.
  92 Input mode is terminated by entering a single period
  93 .Pq Ql \&.
  94 on a line.
  95 .Pp
  96 All
  97 .Nm
  98 commands operate on whole lines or ranges of lines; e.g.,
  99 the
 100 .Ic d
 101 command deletes lines; the
 102 .Ic m
 103 command moves lines, and so on.
 104 It is possible to modify only a portion of a line by means of replacement,
 105 as in the example above.
 106 However, even here, the
 107 .Ic s
 108 command is applied to whole lines at a time.
 109 .Pp
 110 In general,
 111 .Nm
 112 commands consist of zero or more line addresses, followed by a single
 113 character command and possibly additional parameters; i.e.,
 114 commands have the structure:
 115 .Bd -literal -offset indent
 116 [address [,address]]command[parameters]
 117 .Ed
 118 .Pp
 119 The address(es) indicate the line or range of lines to be affected by the
 120 command.
 121 If fewer addresses are given than the command accepts, then
 122 default addresses are supplied.
 123 .Pp
 124 The options are as follows:
 125 .Bl -tag -width Ds
 126 .It Fl
 127 Same as the
 128 .Fl s
 129 option (deprecated).
 130 .It Fl E
 131 Enables the use of extended regular expressions instead of the basic
 132 regular expressions that are normally used.
 133 .It Fl p Ar string
 134 Specifies a command prompt.
 135 This may be toggled on and off with the
 136 .Ic P
 137 command.
 138 .It Fl s
 139 Suppress diagnostics.
 140 This should be used if
 141 .Nm
 142 standard input is from a script.
 143 .It Fl x
 144 Prompt for an encryption key to be used in subsequent reads and writes
 145 (see the
 146 .Ic x
 147 command).
 148 .It Ar file
 149 Specifies the name of a file to read.
 150 If
 151 .Ar file
 152 is prefixed with a
 153 bang
 154 .Pq Ql \&! ,
 155 then it is interpreted as a shell command.
 156 In this case, what is read is the standard output of
 157 .Ar file
 158 executed via
 159 .Xr sh 1 .
 160 To read a file whose name begins with a bang, prefix the
 161 name with a backslash
 162 .Pq Ql \e .
 163 The default filename is set to
 164 .Ar file
 165 only if it is not prefixed with a bang.
 166 .El
 167 .Ss LINE ADDRESSING
 168 An address represents the number of a line in the buffer.
 169 .Nm
 170 maintains a
 171 .Em current address
 172 which is typically supplied to commands as the default address
 173 when none is specified.
 174 When a file is first read, the current address is set to the last line
 175 of the file.
 176 In general, the current address is set to the last line affected by a command.
 177 .Pp
 178 A line address is
 179 constructed from one of the bases in the list below, optionally followed
 180 by a numeric offset.
 181 The offset may include any combination of digits, operators (i.e.,
 182 .Sq + ,
 183 .Sq - ,
 184 and
 185 .Sq ^ ) ,
 186 and whitespace.
 187 Addresses are read from left to right, and their values are computed
 188 relative to the current address.
 189 .Pp
 190 One exception to the rule that addresses represent line numbers is the
 191 address
 192 .Em 0
 193 (zero).
 194 This means
 195 .Dq before the first line ,
 196 and is legal wherever it makes sense.
 197 .Pp
 198 An address range is two addresses separated either by a comma or semi-colon.
 199 The value of the first address in a range cannot exceed the
 200 value of the second.
 201 If only one address is given in a range,
 202 then the second address is set to the given address.
 203 If an
 204 .Em n Ns No -tuple
 205 of addresses is given where
 206 .Em n \*[Gt] 2 ,
 207 then the corresponding range is determined by the last two addresses in the
 208 .Em n Ns No -tuple.
 209 If only one address is expected, then the last address is used.
 210 .Pp
 211 Each address in a comma-delimited range is interpreted relative to the
 212 current address.
 213 In a semi-colon-delimited range, the first address is
 214 used to set the current address, and the second address is interpreted
 215 relative to the first.
 216 .Pp
 217 The following address symbols are recognized:
 218 .Bl -tag -width Ds
 219 .It Em \&.
 220 The current line (address) in the buffer.
 221 .It Em $
 222 The last line in the buffer.
 223 .It Em n
 224 The
 225 .Em n Ns No th
 226 line in the buffer where
 227 .Em n
 228 is a number in the range
 229 .Em [0,$] .
 230 .It Em - No or Em ^
 231 The previous line.
 232 This is equivalent to
 233 .Em -1
 234 and may be repeated with cumulative effect.
 235 .It Em -n No or Em ^n
 236 The
 237 .Em n Ns No th
 238 previous line, where
 239 .Em n
 240 is a non-negative number.
 241 .It Em +
 242 The next line.
 243 This is equivalent to
 244 .Em +1
 245 and may be repeated with cumulative effect.
 246 .It Em +n
 247 The
 248 .Em n Ns No th
 249 next line, where
 250 .Em n
 251 is a non-negative number.
 252 .It Em whitespace Em n
 253 .Em whitespace
 254 followed by a number
 255 .Em n
 256 is interpreted as
 257 .Sq Em +n .
 258 .It Em \&, No or Em %
 259 The first through last lines in the buffer.
 260 This is equivalent to the address range
 261 .Em 1,$ .
 262 .It Em \&;
 263 The current through last lines in the buffer.
 264 This is equivalent to the address range
 265 .Em .,$ .
 266 .It Em / Ns Ar re Ns Em /
 267 The next line containing the regular expression
 268 .Ar re .
 269 The search wraps to the beginning of the buffer and continues down to the
 270 current line, if necessary.
 271 .Em //
 272 repeats the last search.
 273 .It Em ? Ns Ar re Ns Em ?
 274 The previous line containing the regular expression
 275 .Ar re .
 276 The search wraps to the end of the buffer and continues up to the
 277 current line, if necessary.
 278 .Em ??
 279 repeats the last search.
 280 .It Em \&\' Ns Ar lc
 281 The line previously marked by a
 282 .Ic k
 283 (mark) command, where
 284 .Ar lc
 285 is a lower case letter.
 286 .El
 287 .Ss REGULAR EXPRESSIONS
 288 Regular expressions are patterns used in selecting text.
 289 For example, the
 290 .Nm
 291 command
 292 .Bd -literal -offset indent
 293 g/string/
 294 .Ed
 295 .Pp
 296 prints all lines containing
 297 .Em string .
 298 Regular expressions are also used by the
 299 .Ic s
 300 command for selecting old text to be replaced with new.
 301 .Pp
 302 In addition to specifying string literals, regular expressions can
 303 represent classes of strings.
 304 Strings thus represented are said to be matched by the
 305 corresponding regular expression.
 306 If it is possible for a regular expression to match several strings in
 307 a line, then the leftmost longest match is the one selected.
 308 .Pp
 309 The following symbols are used in constructing regular expressions:
 310 .Bl -tag -width Dsasdfsd
 311 .It Em c
 312 Any character
 313 .Em c
 314 not listed below, including
 315 .Sq { ,
 316 .Sq } ,
 317 .Sq \&( ,
 318 .Sq \&) ,
 319 .Sq \*[Lt] ,
 320 and
 321 .Sq \*[Gt]
 322 matches itself.
 323 .It Em \ec
 324 Any backslash-escaped character
 325 .Em c ,
 326 except for
 327 .Sq { ,
 328 .Sq } ,
 329 .Sq \&( ,
 330 .Sq \&) ,
 331 .Sq \*[Lt] ,
 332 and
 333 .Sq \*[Gt]
 334 matches itself.
 335 .It Em \&.
 336 Matches any single character.
 337 .It Em [char-class]
 338 Matches any single character in the character class
 339 .Em char-class .
 340 See
 341 .Sx CHARACTER CLASSES
 342 below for further information.
 343 .It Em [^char-class]
 344 Matches any single character, other than newline, not in the
 345 character class
 346 .Em char-class .
 347 .It Em ^
 348 If
 349 .Em ^
 350 is the first character of a regular expression, then it
 351 anchors the regular expression to the beginning of a line.
 352 Otherwise, it matches itself.
 353 .It Em $
 354 If
 355 .Em $
 356 is the last character of a regular expression,
 357 it anchors the regular expression to the end of a line.
 358 Otherwise, it matches itself.
 359 .It Em \e\*[Lt]
 360 Anchors the single character regular expression or subexpression
 361 immediately following it to the beginning of a word.
 362 (This may not be available.)
 363 .It Em \e\*[Gt]
 364 Anchors the single character regular expression or subexpression
 365 immediately following it to the end of a word.
 366 (This may not be available.)
 367 .It Em \e( Ns Ar re Ns Em \e)
 368 Defines a subexpression
 369 .Ar re .
 370 Subexpressions may be nested.
 371 A subsequent backreference of the form
 372 .Em \en ,
 373 where
 374 .Em n
 375 is a number in the range [1,9], expands to the text matched by the
 376 .Em n Ns No th
 377 subexpression.
 378 For example, the regular expression
 379 .Em \e(.*\e)\e1
 380 matches any string consisting of identical adjacent substrings.
 381 Subexpressions are ordered relative to their left delimiter.
 382 .It Em *
 383 Matches the single character regular expression or subexpression
 384 immediately preceding it zero or more times.
 385 If
 386 .Em *
 387 is the first character of a regular expression or subexpression,
 388 then it matches itself.
 389 The
 390 .Em *
 391 operator sometimes yields unexpected results.
 392 For example, the regular expression
 393 .Em b*
 394 matches the beginning of the string
 395 .Em abbb
 396 (as opposed to the substring
 397 .Em bbb ) ,
 398 since a null match is the only leftmost match.
 399 .Sm off
 400 .It Em \e{ No n,m Em \e}\ \e{ No n, Em \e}\ \& Em \e{ No n Em \e}
 401 .Sm on
 402 Matches the single character regular expression or subexpression
 403 immediately preceding it at least
 404 .Em n
 405 and at most
 406 .Em m
 407 times.
 408 If
 409 .Em m
 410 is omitted, then it matches at least
 411 .Em n
 412 times.
 413 If the comma is also omitted, then it matches exactly
 414 .Em n
 415 times.
 416 .El
 417 .Pp
 418 Additional regular expression operators may be defined depending on the
 419 particular
 420 .Xr regex 3
 421 implementation.
 422 .Ss CHARACTER CLASSES
 423 A character class specifies a set of characters. It is written within
 424 square brackets
 425 .Pq []
 426 and in its most basic form contains just the characters in the set.
 427 .Pp
 428 To include a
 429 .Sq \&]
 430 in a character class, it must be the first character.
 431 A range of characters may be specified by separating the end characters
 432 of the range with a
 433 .Sq \&- ,
 434 e.g.,
 435 .Sq a-z
 436 specifies the lower case characters.
 437 .Pp
 438 The following literals can also be used within character classes as
 439 shorthand for particular sets of characters:
 440 .Bl -tag -offset indent -compact -width [:blahblah:]
 441 .It [:alnum:]
 442 Alphanumeric characters.
 443 .It [:cntrl:]
 444 Control characters.
 445 .It [:lower:]
 446 Lowercase alphabetic characters.
 447 .It [:space:]
 448 Whitespace (space, tab, newline, form feed, etc.)
 449 .It [:alpha:]
 450 Alphabetic characters.
 451 .It [:digit:]
 452 Numeric characters (digits).
 453 .It [:print:]
 454 Printable characters.
 455 .It [:upper:]
 456 Uppercase alphabetic characters.
 457 .It [:blank:]
 458 Blank characters (space and tab).
 459 .It [:graph:]
 460 Graphical characters (printing nonblank characters).
 461 .It [:punct:]
 462 Punctuation characters.
 463 .It [:xdigit:]
 464 Hexadecimal digits.
 465 .El
 466 If
 467 .Sq \&-
 468 appears as the first or last character of a character class, then
 469 it matches itself.
 470 All other characters in a character class match themselves.
 471 .Pp
 472 Patterns in
 473 a character class
 474 of the form
 475 .Em [.col-elm.]
 476 or
 477 .Em [=col-elm=]
 478 where
 479 .Em col-elm
 480 is a
 481 .Em collating element
 482 are interpreted according to
 483 .Xr locale 5
 484 (not currently supported).
 485 See
 486 .Xr regex 3
 487 for an explanation of these constructs.
 488 .Ss COMMANDS
 489 All
 490 .Nm
 491 commands are single characters, though some require additional parameters.
 492 If a command's parameters extend over several lines, then
 493 each line except for the last must be terminated with a backslash
 494 .Pq Ql \e .
 495 .Pp
 496 In general, at most one command is allowed per line.
 497 However, most commands accept a print suffix, which is any of
 498 .Ic p
 499 (print),
 500 .Ic l
 501 (list),
 502 or
 503 .Ic n
 504 (enumerate), to print the last line affected by the command.
 505 .Pp
 506 An interrupt (typically ^C) has the effect of aborting the current command
 507 and returning the editor to command mode.
 508 .Pp
 509 .Nm
 510 recognizes the following commands.
 511 The commands are shown together with
 512 the default address or address range supplied if none is
 513 specified (in parentheses), and other possible arguments on the right.
 514 .Bl -tag -width Dxxs
 515 .It (.) Ns Ic a
 516 Appends text to the buffer after the addressed line.
 517 Text is entered in input mode.
 518 The current address is set to last line entered.
 519 .It (.,.) Ns Ic c
 520 Changes lines in the buffer.
 521 The addressed lines are deleted from the buffer,
 522 and text is appended in their place.
 523 Text is entered in input mode.
 524 The current address is set to last line entered.
 525 .It (.,.) Ns Ic d
 526 Deletes the addressed lines from the buffer.
 527 If there is a line after the deleted range, then the current address is set
 528 to this line.
 529 Otherwise the current address is set to the line before the deleted range.
 530 .It Ic e Ar file
 531 Edits
 532 .Ar file ,
 533 and sets the default filename.
 534 If
 535 .Ar file
 536 is not specified, then the default filename is used.
 537 Any lines in the buffer are deleted before the new file is read.
 538 The current address is set to the last line read.
 539 .It Ic e Ar !command
 540 Edits the standard output of
 541 .Ar command ,
 542 (see
 543 .Ic \&! Ar command
 544 below).
 545 The default filename is unchanged.
 546 Any lines in the buffer are deleted before the output of
 547 .Em command
 548 is read.
 549 The current address is set to the last line read.
 550 .It Ic E Ar file
 551 Edits
 552 .Ar file
 553 unconditionally.
 554 This is similar to the
 555 .Ic e
 556 command, except that unwritten changes are discarded without warning.
 557 The current address is set to the last line read.
 558 .It Ic f Ar file
 559 Sets the default filename to
 560 .Ar file .
 561 If
 562 .Ar file
 563 is not specified, then the default unescaped filename is printed.
 564 .It (1,$) Ns Ic g Ns Ar /re/command-list
 565 Applies
 566 .Ar command-list
 567 to each of the addressed lines matching a regular expression
 568 .Ar re .
 569 The current address is set to the line currently matched before
 570 .Ar command-list
 571 is executed.
 572 At the end of the
 573 .Ic g
 574 command, the current address is set to the last line affected by
 575 .Ar command-list .
 576 .Pp
 577 Each command in
 578 .Ar command-list
 579 must be on a separate line,
 580 and every line except for the last must be terminated by a backslash
 581 .Pq Sq \e .
 582 Any commands are allowed, except for
 583 .Ic g ,
 584 .Ic G ,
 585 .Ic v ,
 586 and
 587 .Ic V .
 588 A newline alone in
 589 .Ar command-list
 590 is equivalent to a
 591 .Ic p
 592 command.
 593 .It (1,$) Ns Ic G Ns Ar /re/
 594 Interactively edits the addressed lines matching a regular expression
 595 .Ar re .
 596 For each matching line, the line is printed, the current address is set,
 597 and the user is prompted to enter a
 598 .Ar command-list .
 599 At the end of the
 600 .Ic G
 601 command, the current address is set to the last line affected by (the last)
 602 .Ar command-list .
 603 .Pp
 604 The format of
 605 .Ar command-list
 606 is the same as that of the
 607 .Ic g
 608 command.
 609 A newline alone acts as a null command list.
 610 A single
 611 .Sq \*[Am]
 612 repeats the last non-null command list.
 613 .It Ic H
 614 Toggles the printing of error explanations.
 615 By default, explanations are not printed.
 616 It is recommended that
 617 .Nm
 618 scripts begin with this command to aid in debugging.
 619 .It Ic h
 620 Prints an explanation of the last error.
 621 .It (.) Ns Ic i
 622 Inserts text in the buffer before the current line.
 623 Text is entered in input mode.
 624 The current address is set to the last line entered.
 625 .It (.,.+1) Ns Ic j
 626 Joins the addressed lines.
 627 The addressed lines are deleted from the buffer and replaced by a single
 628 line containing their joined text.
 629 The current address is set to the resultant line.
 630 .It (.) Ns Ic k Ns Ar lc
 631 Marks a line with a lower case letter
 632 .Ar lc .
 633 The line can then be addressed as
 634 .Ar \&'lc
 635 (i.e., a single quote followed by
 636 .Ar lc )
 637 in subsequent commands.
 638 The mark is not cleared until the line is deleted or otherwise modified.
 639 .It (.,.) Ns Ic l
 640 Prints the addressed lines unambiguously.
 641 If a single line fills more than one screen (as might be the case
 642 when viewing a binary file, for instance), a
 643 .Dq --More--
 644 prompt is printed on the last line.
 645 .Nm
 646 waits until the RETURN key is pressed before displaying the next screen.
 647 The current address is set to the last line printed.
 648 .It (.,.) Ns Ic m Ns No (.)
 649 Moves lines in the buffer.
 650 The addressed lines are moved to after the
 651 right-hand destination address, which may be the address
 652 .Em 0
 653 (zero).
 654 The current address is set to the last line moved.
 655 .It (.,.) Ns Ic n
 656 Prints the addressed lines along with their line numbers.
 657 The current address is set to the last line printed.
 658 .It (.,.) Ns Ic p
 659 Prints the addressed lines.
 660 The current address is set to the last line printed.
 661 .It Ic P
 662 Toggles the command prompt on and off.
 663 Unless a prompt was specified with the command-line option
 664 .Fl p Ar string ,
 665 the command prompt is by default turned off.
 666 .It Ic q
 667 Quits
 668 .Nm .
 669 .It Ic Q
 670 Quits
 671 .Nm
 672 unconditionally.
 673 This is similar to the
 674 .Ic q
 675 command, except that unwritten changes are discarded without warning.
 676 .It ($) Ns Ic r Ar file
 677 Reads
 678 .Ar file
 679 to after the addressed line.
 680 If
 681 .Ar file
 682 is not specified, then the default filename is used.
 683 If there was no default filename prior to the command,
 684 then the default filename is set to
 685 .Ar file .
 686 Otherwise, the default filename is unchanged.
 687 The current address is set to the last line read.
 688 .It ($) Ns Ic r Ar !command
 689 Reads to after the addressed line the standard output of
 690 .Ar command ,
 691 (see the
 692 .Ic \&!
 693 command below).
 694 The default filename is unchanged.
 695 The current address is set to the last line read.
 696 .Sm off
 697 .It (.,.) Ic s Ar /re/replacement/ , \ (.,.) \
 698 Ic s Ar /re/replacement/ Em g , Ar \ (.,.) \
 699 Ic s Ar /re/replacement/ Em n
 700 .Sm on
 701 Replaces text in the addressed lines matching a regular expression
 702 .Ar re
 703 with
 704 .Ar replacement .
 705 By default, only the first match in each line is replaced.
 706 If the
 707 .Em g
 708 (global) suffix is given, then every match to be replaced.
 709 The
 710 .Em n
 711 suffix, where
 712 .Em n
 713 is a positive number, causes only the
 714 .Em n Ns No th
 715 match to be replaced.
 716 It is an error if no substitutions are performed on any of the addressed
 717 lines.
 718 The current address is set the last line affected.
 719 .Pp
 720 .Ar re
 721 and
 722 .Ar replacement
 723 may be delimited by any character other than space and newline
 724 (see the
 725 .Ic s
 726 command below).
 727 If one or two of the last delimiters is omitted, then the last line
 728 affected is printed as though the print suffix
 729 .Em p
 730 were specified.
 731 .Pp
 732 An unescaped
 733 .Ql \*[Am]
 734 in
 735 .Ar replacement
 736 is replaced by the currently matched text.
 737 The character sequence
 738 .Em \em ,
 739 where
 740 .Em m
 741 is a number in the range [1,9], is replaced by the
 742 .Em m Ns No th
 743 backreference expression of the matched text.
 744 If
 745 .Ar replacement
 746 consists of a single
 747 .Ql % ,
 748 then
 749 .Ar replacement
 750 from the last substitution is used.
 751 Newlines may be embedded in
 752 .Ar replacement
 753 if they are escaped with a backslash
 754 .Pq Ql \e .
 755 .It (.,.) Ns Ic s
 756 Repeats the last substitution.
 757 This form of the
 758 .Ic s
 759 command accepts a count suffix
 760 .Em n ,
 761 or any combination of the characters
 762 .Em r ,
 763 .Em g ,
 764 and
 765 .Em p .
 766 If a count suffix
 767 .Em n
 768 is given, then only the
 769 .Em n Ns No th
 770 match is replaced.
 771 The
 772 .Em r
 773 suffix causes
 774 the regular expression of the last search to be used instead of
 775 that of the last substitution.
 776 The
 777 .Em g
 778 suffix toggles the global suffix of the last substitution.
 779 The
 780 .Em p
 781 suffix toggles the print suffix of the last substitution.
 782 The current address is set to the last line affected.
 783 .It (.,.) Ns Ic t Ns No (.)
 784 Copies (i.e., transfers) the addressed lines to after the right-hand
 785 destination address, which may be the address
 786 .Em 0
 787 (zero).
 788 The current address is set to the last line copied.
 789 .It Ic u
 790 Undoes the last command and restores the current address
 791 to what it was before the command.
 792 The global commands
 793 .Ic g ,
 794 .Ic G ,
 795 .Ic v ,
 796 and
 797 .Ic V
 798 are treated as a single command by undo.
 799 .Ic u
 800 is its own inverse.
 801 .It (1,$) Ns Ic v Ns Ar /re/command-list
 802 Applies
 803 .Ar command-list
 804 to each of the addressed lines not matching a regular expression
 805 .Ar re .
 806 This is similar to the
 807 .Ic g
 808 command.
 809 .It (1,$) Ns Ic V Ns Ar /re/
 810 Interactively edits the addressed lines not matching a regular expression
 811 .Ar re .
 812 This is similar to the
 813 .Ic G
 814 command.
 815 .It (1,$) Ns Ic w Ar file
 816 Writes the addressed lines to
 817 .Ar file .
 818 Any previous contents of
 819 .Ar file
 820 are lost without warning.
 821 If there is no default filename, then the default filename is set to
 822 .Ar file ,
 823 otherwise it is unchanged.
 824 If no filename is specified, then the default filename is used.
 825 The current address is unchanged.
 826 .It (1,$) Ns Ic wq Ar file
 827 Writes the addressed lines to
 828 .Ar file ,
 829 and then executes a
 830 .Ic q
 831 command.
 832 .It (1,$) Ns Ic w Ar !command
 833 Writes the addressed lines to the standard input of
 834 .Ar command ,
 835 (see the
 836 .Ic \&!
 837 command below).
 838 The default filename and current address are unchanged.
 839 .It (1,$) Ns Ic W Ar file
 840 Appends the addressed lines to the end of
 841 .Ar file .
 842 This is similar to the
 843 .Ic w
 844 command, except that the previous contents of file are not clobbered.
 845 The current address is unchanged.
 846 .It Ic x
 847 Prompts for an encryption key which is used in subsequent reads and writes.
 848 If a newline alone is entered as the key, then encryption is turned off.
 849 Otherwise, echoing is disabled while a key is read.
 850 Encryption/decryption is done using the
 851 .Xr bdes 1
 852 algorithm.
 853 .It (.+1) Ns Ic z Ns Ar n
 854 Scrolls
 855 .Ar n
 856 lines at a time starting at addressed line.
 857 If
 858 .Ar n
 859 is not specified, then the current window size is used.
 860 The current address is set to the last line printed.
 861 .It ($) Ns Ic =
 862 Prints the line number of the addressed line.
 863 .It (.+1) Ns Ic newline
 864 Prints the addressed line, and sets the current address to that line.
 865 .It Ic \&! Ns Ar command
 866 Executes
 867 .Ar command
 868 via
 869 .Xr sh 1 .
 870 If the first character of
 871 .Ar command
 872 is
 873 .Ic \&! ,
 874 then it is replaced by text of the previous
 875 .Ic !command .
 876 .Nm
 877 does not process
 878 .Ar command
 879 for
 880 .Sq \e
 881 (backslash) escapes.
 882 However, an unescaped
 883 .Sq %
 884 is replaced by the default filename.
 885 When the shell returns from execution, a
 886 .Sq !
 887 is printed to the standard output.
 888 The current line is unchanged.
 889 .El
 890 .Sh LIMITATIONS
 891 .Nm
 892 processes
 893 .Em file
 894 arguments for backslash escapes, i.e., in a filename,
 895 any characters preceded by a backslash
 896 .Pq Ql \e
 897 are interpreted literally.
 898 .Pp
 899 If a text (non-binary) file is not terminated by a newline character,
 900 then
 901 .Nm
 902 appends one on reading/writing it.
 903 In the case of a binary file,
 904 .Nm
 905 does not append a newline on reading/writing.
 906 .Sh ENVIRONMENT
 907 .Bl -tag -width iTMPDIR
 908 .It Ev TMPDIR
 909 The location used to store temporary files.
 910 .El
 911 .Sh FILES
 912 .Bl -tag -width /tmp/ed.* -compact
 913 .It Pa /tmp/ed.*
 914 buffer file
 915 .It Pa ed.hup
 916 where
 917 .Nm
 918 attempts to write the buffer if the terminal hangs up
 919 .El
 920 .Sh DIAGNOSTICS
 921 When an error occurs,
 922 .Nm
 923 prints a
 924 .Dq ?
 925 and either returns to command mode or exits if its input is from a script.
 926 An explanation of the last error can be printed with the
 927 .Ic h
 928 (help) command.
 929 .Pp
 930 Since the
 931 .Ic g
 932 (global) command masks any errors from failed searches and substitutions,
 933 it can be used to perform conditional operations in scripts; e.g.,
 934 .Bd -literal -offset indent
 935 g/old/s//new/
 936 .Ed
 937 .Pp
 938 replaces any occurrences of
 939 .Em old
 940 with
 941 .Em new .
 942 .Pp
 943 If the
 944 .Ic u
 945 (undo) command occurs in a global command list, then
 946 the command list is executed only once.
 947 .Pp
 948 If diagnostics are not disabled, attempting to quit
 949 .Nm
 950 or edit another file before writing a modified buffer results in an error.
 951 If the command is entered a second time, it succeeds,
 952 but any changes to the buffer are lost.
 953 .Sh SEE ALSO
 954 .Xr bdes 1 ,
 955 .Xr sed 1 ,
 956 .Xr sh 1 ,
 957 .Xr vi 1 ,
 958 .Xr regex 3
 959 .Pp
 960 USD:09-10
 961 .Rs
 962 .%A B. W. Kernighan
 963 .%A P. J. Plauger
 964 .%B Software Tools in Pascal
 965 .%I Addison-Wesley
 966 .%D 1981
 967 .Re
 968 .Sh HISTORY
 969 An
 970 .Nm
 971 command appeared in
 972 .At v1 .