/usr/share/doc/psgml/Edit.html is in psgml 1.4.0-7.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.3, http://www.gnu.org/software/texinfo/ -->
<head>
<title>psgml: Edit</title>
<meta name="description" content="psgml: Edit">
<meta name="keywords" content="psgml: Edit">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Index.html#Index" rel="index" title="Index">
<link href="Index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html#Top" rel="up" title="Top">
<link href="Display.html#Display" rel="next" title="Display">
<link href="Managing-the-DTD.html#Customizing-DTD" rel="prev" title="Customizing DTD">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en">
<a name="Edit"></a>
<div class="header">
<p>
Next: <a href="Display.html#Display" accesskey="n" rel="next">Display</a>, Previous: <a href="Managing-the-DTD.html#Managing-the-DTD" accesskey="p" rel="prev">Managing the DTD</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> [<a href="Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Commands-for-editing"></a>
<h2 class="chapter">8 Commands for editing</h2>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a href="#Insert" accesskey="1">Insert</a>:</td><td> </td><td align="left" valign="top">Inserting Markup
</td></tr>
<tr><td align="left" valign="top">• <a href="#Complete" accesskey="2">Complete</a>:</td><td> </td><td align="left" valign="top">Markup completion
</td></tr>
<tr><td align="left" valign="top">• <a href="#Information" accesskey="3">Information</a>:</td><td> </td><td align="left" valign="top">Showing information
</td></tr>
<tr><td align="left" valign="top">• <a href="#Indent" accesskey="4">Indent</a>:</td><td> </td><td align="left" valign="top">Indentation according to structure
</td></tr>
<tr><td align="left" valign="top">• <a href="#Move" accesskey="5">Move</a>:</td><td> </td><td align="left" valign="top">Move in the element structure
</td></tr>
<tr><td align="left" valign="top">• <a href="#Attributes" accesskey="6">Attributes</a>:</td><td> </td><td align="left" valign="top">Editing attributes
</td></tr>
<tr><td align="left" valign="top">• <a href="#Change-and-delete" accesskey="7">Change and delete</a>:</td><td> </td><td align="left" valign="top">Changing and deleting markup
</td></tr>
<tr><td align="left" valign="top">• <a href="#Translating-characters-and-entities" accesskey="8">Translating characters and entities</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
<a name="Insert"></a>
<div class="header">
<p>
Next: <a href="#Complete" accesskey="n" rel="next">Complete</a>, Previous: <a href="#Edit" accesskey="p" rel="prev">Edit</a>, Up: <a href="#Edit" accesskey="u" rel="up">Edit</a> [<a href="Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Inserting-Markup"></a>
<h3 class="section">8.1 Inserting Markup</h3>
<p>The commands that insert start-tags works only if the document has an
associated DTD.
</p>
<p>Keyboard commands for inserting:
</p>
<dl compact="compact">
<dd><a name="index-C_002dc-_003c"></a>
<a name="index-sgml_002dinsert_002dtag"></a>
</dd>
<dt><kbd>C-c <</kbd></dt>
<dd><p>Will ask, for the tag to insert, in the mini-buffer with completion on the
tags that are valid at point (<code>sgml-insert-tag</code>).
</p>
<p>If <code>sgml-auto-insert-required-elements</code> is non-nil, tags for elements
required between the inserted tags will also be inserted.
</p>
<p>The list of valid tags, computed for a position in the buffer, will
contain:
</p>
<ol>
<li> The end-tag for the current element, if it can be ended at the position.
Furthermore it will contain end-tags for enclosing elements if the
necessary omissible end-tag declarations have been made in the DTD.
</li><li> The start-tags of all elements that could occur after point. If
<code>sgml-omittag-transparent</code> is nil, the above will be limited to the
elements that can occur within the current element.
</li></ol>
<a name="index-C_002dc-C_002de"></a>
<a name="index-sgml_002dinsert_002delement"></a>
<a name="index-sgml_002dinsert_002dend_002dtag_002don_002dnew_002dline"></a>
</dd>
<dt><kbd>C-c C-e</kbd></dt>
<dd><p>Insert start and end-tags for an element
(<code>sgml-insert-element</code>). The name of the element is read
from the mini-buffer with completion on valid elements. If
<code>sgml-insert-end-tag-on-new-line</code> is non-nil or the
element has element content, the end-tag will be inserted on a
new line after the start-tag.
</p>
<a name="index-sgml_002domittag_002dtransparent"></a>
<p>If <code>sgml-omittag-transparent</code> is nil, the list of valid elements
will only contain the elements that can be in the content of the current
element.
</p>
<a name="index-sgml_002dauto_002dinsert_002drequired_002delements"></a>
<a name="index-sgml_002dinsert_002dmissing_002delement_002dcomment"></a>
<p>Required elements in the content will be automatically inserted if the
option <code>sgml-auto-insert-required-elements</code> is non-nil.
When the content model demands an element but there is more
than one to choose from, a comment can be inserted with the
available choices if the option
<code>sgml-insert-missing-element-comment</code> is non-nil.
</p>
<a name="index-C_002dc-C_002di"></a>
<a name="index-sgml_002dadd_002delement_002dto_002delement"></a>
</dd>
<dt><kbd>C-c C-i</kbd></dt>
<dd><p>Inserts a new element in the current element where it is legal. Prompts
for element name with completion. The completion list contains all
elements that could be added to the current element somewhere, without
making the content invalid. This assumes that the content is valid to
begin with. Currently this list only has regular elements, not
inclusions. The new element will be inserted as late as possible in the
current element (unless prefix argument is given, then as early as
possible.)
</p>
<a name="index-C_002dc-C_002dr"></a>
<a name="index-sgml_002dtag_002dregion"></a>
</dd>
<dt><kbd>C-c C-r</kbd></dt>
<dd><p>Makes the region into a new element (<code>sgml-tag-region</code>). Reads
element name from mini-buffer with completion as for <kbd>C-c C-e</kbd>.
</p>
<a name="index-C_002dc-_002f"></a>
<a name="index-sgml_002dinsert_002dend_002dtag"></a>
</dd>
<dt><kbd>C-c /</kbd></dt>
<dd><p>Inserts an end-tag for the current element (<code>sgml-insert-end-tag</code>).
</p>
<a name="index-C_002dc-RET"></a>
<a name="index-sgml_002dsplit_002delement"></a>
</dd>
<dt><kbd>C-c RET</kbd></dt>
<dd><p>Split the current element at point. If repeated, the containing element
will be split before the beginning of then current element.
</p>
<p>Typical use is to start a new paragraph element when inside a paragraph.
</p>
<a name="index-C_002dc-_002b"></a>
<a name="index-sgml_002dinsert_002dattribute"></a>
</dd>
<dt><kbd>C-c +</kbd></dt>
<dd><p>Read attribute name and value from mini-buffer and insert attribute
specification (<code>sgml-insert-attribute</code>). If point is immediately
after a start-tag, this command operates on that start-tag. Otherwise
the command will operate on the element after point.
</p>
<p>The attribute name will be read with completion. If the attribute has a
token list as declared value the attribute value will also be read with
completion. The prompt for attribute value will typically look like:
</p>
<div class="example">
<pre class="example">Value for <var>attribute</var> (<var>type</var> Default: <var>current value</var>):
</pre></div>
<a name="index-C_002dc-C_002du-C_002dm"></a>
<a name="index-sgml_002dcustom_002dmarkup"></a>
</dd>
<dt><kbd>C-c C-u C-m</kbd></dt>
<dd><p>Give keyboard access to the customized part of the Markup menu.
Emacs will prompt for the markup to insert using the menu line as
selector. (See <var>sgml-custom-markup</var> below.)
</p>
</dd>
</dl>
<p>Menu bar:
</p>
<dl compact="compact">
<dt>‘<samp>Markup</samp>’</dt>
<dd><p>Selecting from this menu will insert markup. The menu contains
sub menus with tags and with entities, some other markup and a user
defined section.
</p>
<p>Sub menus:
</p>
</dd>
<dt>‘<samp>Insert element</samp>’</dt>
<dd><p>Pops up a menu of valid elements and insert start and end-tags for
the selected element. Selections from the menu works like the <kbd>C-c
C-e</kbd> command.
</p>
</dd>
<dt>‘<samp>Insert start-tag</samp>’</dt>
<dd><p>Pops up a menu of valid start-tags and insert the selected tag. The
menu has the same start-tags as the completion list for <kbd>C-c <</kbd>.
</p>
</dd>
<dt>‘<samp>Insert end-tag</samp>’</dt>
<dd><p>Pops up a menu of valid end-tags and insert the selected tag.
</p>
</dd>
<dt>‘<samp>Tag region</samp>’</dt>
<dd><p>Pops up a menu of valid elements and tag the region with the
selection. Selections from the menu works like the <kbd>C-c C-r</kbd>
command.
</p>
</dd>
<dt>‘<samp>Insert entity</samp>’</dt>
<dd><p>Menu of all general entities defined in the DTD.
</p>
</dd>
<dt>‘<samp>Add Element to Element</samp>’</dt>
<dd><p>Pops up a menu of all elements valid somewhere in the current element.
The menu contains all elements that could be added to the current
element somewhere, without making the content invalid. The new element
will be inserted as late as possible in the current element.
</p>
</dd>
<dt>‘<samp>Insert attribute</samp>’</dt>
<dd><p>Pops up a menu with all the attributes of an element. The element is
either the one which start-tag is immediately before point or the
element after point. Selecting from this menu edits the attribute
specification list for the element.
</p>
<p>The menu has a sub menu for every attribute which declared value is a
token list. The rest of the attributes are collected in one sub menu.
For the token list attributes, selecting a value will insert that
attribute-value pair. Selecting some other attribute reads the
attribute-value from the mini-buffer and inserts the attribute value
pair.
</p></dd>
</dl>
<a name="index-S_002dmouse_002d3"></a>
<p>A menu is also available directly with a mouse button click in the
buffer. In GNU Emacs it is the first mouse button combined with shift
(<kbd>S-<span class="key">mouse-3</span></kbd>). In Lucid Emacs it is bound to the third mouse
button. The mouse button click will pop-up a menu of valid tags or a
menu of attributes if the point is in a start-tag. The attributes menu
works as the “Insert attribute” menu from the menu-bar. The tags list
is the list of valid tags described above for command <kbd>C-c <</kbd>.
Selection from the tags menu works like the <kbd>C-c <</kbd> command, with
the following exception:
</p>
<p>You can tag a region, with start and end-tag. There are two ways to
indicate the region to mark:
</p>
<ol>
<li> Use the normal mouse commands to mark region.
<p>For this to work you must either use <em>transient mark mode</em>
(see <a href="http://www.gnu.org/software/emacs/manual/html_node/emacs/Transient-Mark.html#Transient-Mark">Transient Mark Mode</a> in <cite>The Emacs
Editor</cite>) or set the option <code>sgml-tag-region-if-active</code> to non-nil
(don’t set this unless you are sure that you want it).
</p>
</li><li> Alternatively make a secondary selection, this is done by holding down
the meta key and using the mouse buttons.
See <a href="http://www.gnu.org/software/emacs/manual/html_node/emacs/Secondary-selection.html#Secondary-selection">Secondary selection</a> in <cite>The Emacs Editor</cite>.
Some window managers intercept these events, which makes it hard use the
secondary selection in Emacs.
</li></ol>
<dl>
<dt><a name="index-sgml_002dbalanced_002dtag_002dedit"></a>User Option: <strong>sgml-balanced-tag-edit</strong></dt>
<dd><p>If non-nil, inserting a start-tag using the context menu will also
insert the corresponding end-tag.
</p></dd></dl>
<dl>
<dt><a name="index-sgml_002dauto_002dinsert_002drequired_002delements-1"></a>User Option: <strong>sgml-auto-insert-required-elements</strong></dt>
<dd><p>If non-nil, automatically inserts required elements in the content
of an inserted element.
</p></dd></dl>
<dl>
<dt><a name="index-sgml_002domittag_002dtransparent-1"></a>User Option: <strong>sgml-omittag-transparent</strong></dt>
<dd><p>If non-nil, will show legal tags inside elements with omissible start-tags
and legal tags beyond omissible end-tags.
</p></dd></dl>
<dl>
<dt><a name="index-sgml_002dtag_002dregion_002dif_002dactive"></a>User Option: <strong>sgml-tag-region-if-active</strong></dt>
<dd><p>If non-nil, the ‘<samp>Insert tags</samp>’ menu will tag a region if the region
is considered active by emacs. If nil, region must be active and
<code>transient-mark-mode</code> must be on for the region to be tagged.
</p></dd></dl>
<dl>
<dt><a name="index-sgml_002dcustom_002dmarkup-1"></a>User Option: <strong>sgml-custom-markup</strong></dt>
<dd><p>Menu entries to be added to the Markup menu. The value should be a list
of lists of two strings. The first string is the menu line and the
second string is the text inserted when the menu item is selected. The
second string can contain a ‘<samp>\r</samp>’ where the cursor should be left.
Also, if a selection is made according to the same rules as for the
<kbd>S-mouse-1</kbd> menu, the selection is replaced with the second string
and ‘<samp>\r</samp>’ is replaced with the selection.
</p>
<p>Example:
</p>
<div class="example">
<pre class="example"> (("Version1" "<![%Version1[\r]]>")
("New page" "<?NewPage>"))
</pre></div>
</dd></dl>
<dl>
<dt><a name="index-sgml_002dinsert_002dmissing_002delement_002dcomment-1"></a>User Option: <strong>sgml-insert-missing-element-comment</strong></dt>
<dd><p>If non-nil, and sgml-auto-insert-required-elements also true,
<code>sgml-insert-element</code> will insert a comment if there is an
element required but there is more than one to choose from.
</p></dd></dl>
<dl>
<dt><a name="index-sgml_002dinsert_002dend_002dtag_002don_002dnew_002dline-1"></a>User Option: <strong>sgml-insert-end-tag-on-new-line</strong></dt>
<dd><p>If non-nil, <code>sgml-insert-element</code> will put the end-tag on
a new line after the start-tag. Useful on slow terminals if you
find the end-tag after the cursor irritating.
</p></dd></dl>
<hr>
<a name="Complete"></a>
<div class="header">
<p>
Next: <a href="#Information" accesskey="n" rel="next">Information</a>, Previous: <a href="#Insert" accesskey="p" rel="prev">Insert</a>, Up: <a href="#Edit" accesskey="u" rel="up">Edit</a> [<a href="Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Markup-completion"></a>
<h3 class="section">8.2 Markup completion</h3>
<a name="index-M_002dTAB"></a>
<a name="index-sgml_002dcomplete"></a>
<p>If you are typing in markup directly, <kbd>M-TAB</kbd> will help you by
completing a tag name, an entity name or a markup declaration name. If
you type <kbd>M-TAB</kbd> after a plain word, <code>ispell-complete-word</code>
will be invoked instead.
</p>
<p>If you have typed (∗ marks the position of point)
</p>
<div class="example">
<pre class="example">&At∗
</pre></div>
<p>and type <kbd>M-TAB</kbd> (assuming you use the <samp>ISOLat1</samp>
entity set) you get:
</p>
<div class="example">
<pre class="example">&Atilde∗
</pre></div>
<hr>
<a name="Information"></a>
<div class="header">
<p>
Next: <a href="#Indent" accesskey="n" rel="next">Indent</a>, Previous: <a href="#Complete" accesskey="p" rel="prev">Complete</a>, Up: <a href="#Edit" accesskey="u" rel="up">Edit</a> [<a href="Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Showing-information"></a>
<h3 class="section">8.3 Showing information</h3>
<p>Commands for showing information obtained by parsing the buffer.
</p>
<dl compact="compact">
<dd><a name="index-C_002dc-C_002dc"></a>
<a name="index-sgml_002dshow_002dcontext"></a>
</dd>
<dt><kbd>C-c C-c</kbd></dt>
<dd><p>Shows in the message area: context at point, if in a tag or in mixed
content and the open elements (<code>sgml-show-context</code>). The form of
the string is controled by the user option
<code>sgml-show-context-function</code>.
</p>
<a name="index-C_002dc-C_002dw"></a>
<a name="index-sgml_002dwhat_002delement"></a>
</dd>
<dt><kbd>C-c C-w</kbd></dt>
<dd><p>Shows what element the character after point (under the cursor) belongs
to; also shows context of element (<code>sgml-what-element</code>).
</p>
<a name="index-C_002dc-C_002dt"></a>
<a name="index-sgml_002dshow_002dcurrent_002delement_002dtype"></a>
</dd>
<dt><kbd>C-c C-t</kbd></dt>
<dd><p>Show information about the current element type and the valid element
following the point.
</p>
<a name="index-C_002dc-C_002ds"></a>
<a name="index-sgml_002dshow_002dstructure"></a>
</dd>
<dt><kbd>C-c C-s</kbd></dt>
<dd><p>Show the major element structure in a separate buffer (‘<samp>*Document
structure*</samp>’). That buffer can be used to navigate the document, like
an Occur buffer (see <a href="http://www.gnu.org/software/emacs/manual/html_node/emacs/Other-Repeating-Search.html#Other-Repeating-Search">Other
Search-and-Loop Commands</a> in <cite>The Emacs Editor</cite>). The structure
shows container elements and the text of the first child element (if
it is not a container). This works best for document types which uses
containers and title structure (e.g. ‘<samp><div> <title>Heder</title>
..</div></samp>’). PSGML uses a heuristic rule to identify container
elements: it should have element content and be non empty. You can
configure exceptions from this rule using a process instruction in the
DTD (see <a href="Managing-the-DTD.html#Customizing-DTD">Customizing DTD</a>).
</p>
<p>To include an element type <var>el1</var> that would otherwise be excluded:
</p><div class="example">
<pre class="example"><?PSGML element <var>el1</var> structure=t?>
</pre></div>
<p>To exclude an element type <var>el2</var> that would otherwise be included:
</p><div class="example">
<pre class="example"><?PSGML element <var>el2</var> structure=ignore?>
</pre></div>
</dd>
</dl>
<a name="index-sgml_002dlist_002dvalid_002dtags"></a>
<p>List contextually valid tags (<code>sgml-list-valid-tags</code>). Displays
information about current element, all valid end-tags, valid start-tags
in current element, and start-tags valid at this point but in other
elements together with the tags omitted.
</p>
<dl>
<dt><a name="index-sgml_002dshow_002dcontext_002dfunction"></a>User Option: <strong>sgml-show-context-function</strong></dt>
<dd><p>The value shold be a function that generates a string from an element
and the current markup type (if any). There are two ready made
functions for this. The function <code>sgml-show-context-standard</code>,
the default, generates a string like ‘<samp>#PCDATA in para in chapter
in book</samp>’. The function <code>sgml-show-context-backslash</code> generates a
string like ‘<samp>book\chapter\para</samp>’.
</p></dd></dl>
<hr>
<a name="Indent"></a>
<div class="header">
<p>
Next: <a href="#Move" accesskey="n" rel="next">Move</a>, Previous: <a href="#Information" accesskey="p" rel="prev">Information</a>, Up: <a href="#Edit" accesskey="u" rel="up">Edit</a> [<a href="Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Indentation-according-to-structure"></a>
<h3 class="section">8.4 Indentation according to structure</h3>
<a name="index-TAB"></a>
<a name="index-LFD"></a>
<a name="index-sgml_002dindent_002dor_002dtab"></a>
<a name="index-newline_002dand_002dindent"></a>
<p>You can indent a line according to the depth of element nesting at the
beginning of the line. To indent the current line use <kbd><span class="key">TAB</span></kbd>.
You can also use <kbd><span class="key">LFD</span></kbd> (<code>newline-and-indent</code>) to start a
new line with correct indentation.
</p>
<dl>
<dt><a name="index-sgml_002dindent_002dstep"></a>User Option: <strong>sgml-indent-step</strong></dt>
<dd><p>How much to increment indent for every element level. If nil, no
indentation.
</p>
<p>If this is nil, <kbd><span class="key">TAB</span></kbd> will insert a tab instead of indenting.
</p></dd></dl>
<dl>
<dt><a name="index-sgml_002dindent_002ddata"></a>User Option: <strong>sgml-indent-data</strong></dt>
<dd><p>If non-nil, indent in data/mixed context also.
</p></dd></dl>
<hr>
<a name="Move"></a>
<div class="header">
<p>
Next: <a href="#Attributes" accesskey="n" rel="next">Attributes</a>, Previous: <a href="#Indent" accesskey="p" rel="prev">Indent</a>, Up: <a href="#Edit" accesskey="u" rel="up">Edit</a> [<a href="Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Move-in-the-element-structure"></a>
<h3 class="section">8.5 Move in the element structure</h3>
<p>These commands move in the element structure. The commands uses
knowledge of SGML syntax, and if available the specific DTD.
</p>
<dl compact="compact">
<dd><a name="index-C_002dM_002da"></a>
<a name="index-sgml_002dbeginning_002dof_002delement"></a>
</dd>
<dt><kbd>C-M-a</kbd></dt>
<dd><p>Move to the (content) beginning of the current element
(<code>sgml-beginning-of-element</code>).
</p>
<a name="index-C_002dM_002de"></a>
<a name="index-sgml_002dend_002dof_002delement"></a>
</dd>
<dt><kbd>C-M-e</kbd></dt>
<dd><p>Move to the (content) end of the current element (<code>sgml-end-of-element</code>).
</p>
<a name="index-C_002dM_002df"></a>
<a name="index-sgml_002dforward_002delement"></a>
</dd>
<dt><kbd>C-M-f</kbd></dt>
<dd><p>Move forward by element (<code>sgml-forward-element</code>).
</p>
<a name="index-C_002dM_002db"></a>
<a name="index-sgml_002dbackward_002delement"></a>
</dd>
<dt><kbd>C-M-b</kbd></dt>
<dd><p>Move backward by element (<code>sgml-backward-element</code>).
</p>
<a name="index-C_002dM_002du"></a>
<a name="index-sgml_002dbackward_002dup_002delement"></a>
</dd>
<dt><kbd>C-M-u</kbd></dt>
<dd><p>Move up to before current element (<code>sgml-backward-up-element</code>).
</p>
<a name="index-C_002dc-C_002dn"></a>
<a name="index-sgml_002dup_002delement"></a>
</dd>
<dt><kbd>C-c C-n</kbd></dt>
<dd><p>Move up to after current element (<code>sgml-up-element</code>).
</p>
<a name="index-C_002dM_002dd"></a>
<a name="index-sgml_002ddown_002delement"></a>
</dd>
<dt><kbd>C-M-d</kbd></dt>
<dd><p>Move down to the (content) beginning of the next element
(<code>sgml-down-element</code>).
</p>
<a name="index-C_002dc-C_002dd"></a>
<a name="index-sgml_002dnext_002ddata_002dfield"></a>
</dd>
<dt><kbd>C-c C-d</kbd></dt>
<dd><p>Move to the next place where data is allowed (<code>sgml-next-data-field</code>).
</p></dd>
</dl>
<p>You can also move to the next place where there is some structural error
with <kbd>C-c C-o</kbd> (see <a href="Validate.html#Validate">Validate</a>).
</p>
<hr>
<a name="Attributes"></a>
<div class="header">
<p>
Next: <a href="#Change-and-delete" accesskey="n" rel="next">Change and delete</a>, Previous: <a href="#Move" accesskey="p" rel="prev">Move</a>, Up: <a href="#Edit" accesskey="u" rel="up">Edit</a> [<a href="Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Editing-attributes"></a>
<h3 class="section">8.6 Editing attributes</h3>
<a name="index-sgml_002dedit_002dattributes"></a>
<a name="index-C_002dc-C_002da"></a>
<p>If you want to change the attributes of a start-tag you can simply edit
them directly in the buffer. Or you can place the cursor at or after
the start-tag and use the <code>sgml-edit-attributes</code> command, available
from the ‘<samp>SGML</samp>’-menu or on <kbd>C-c C-a</kbd>. This will create a new
Emacs window with all possible attributes listed in the form
</p>
<div class="example">
<pre class="example"><var>attribute name</var> = <var>current value</var>.
</pre></div>
<p>The <var>current value</var> may be shown as ‘<samp>#DEFAULT</samp>’ if the attribute
has not been given a value in the start-tag. The list also contains the
attributes declaration as a comment. Note also that the <var>current
value</var> is show without eventual quotes.
</p>
<a name="index-C_002dc-C_002dd-1"></a>
<a name="index-TAB-1"></a>
<p>It is now possible to edit the attribute values. You can move to the
next attribute with <kbd><span class="key">TAB</span></kbd>. If you want to let an attribute
have its default value use <kbd>C-c C-d</kbd>, this will insert a
‘<samp>#DEFAULT</samp>’ in the value field.
</p>
<p>If Emacs is running in an X window, the ‘<samp>#DEFAULT</samp>’ will be
underlined to distinguish it from normal values.
</p>
<a name="index-C_002dc-C_002dc-1"></a>
<p>Finish the editing with <kbd>C-c C-c</kbd>; this will replace the attribute
values in the main buffer with those edited. Note that values will be
quoted as needed.
</p>
<p>If you want to abort the editing, you can remove the window with
<kbd>C-x 0</kbd> or if you want it neat, kill the buffer and remove the
window.
</p>
<p>Some other keys are:
</p><dl compact="compact">
<dd><a name="index-C_002da"></a>
<a name="index-sgml_002dedit_002dattrib_002dfield_002dstart"></a>
</dd>
<dt><kbd>C-a</kbd></dt>
<dd><p>Go to the beginning of the value field
(<code>sgml-edit-attrib-field-start</code>).
</p>
<a name="index-C_002de"></a>
<a name="index-sgml_002dedit_002dattrib_002dfield_002dend"></a>
</dd>
<dt><kbd>C-e</kbd></dt>
<dd><p>Go to the end of the value field
(<code>sgml-edit-attrib-field-end</code>).
</p>
<a name="index-C_002dc-C_002dk"></a>
<a name="index-sgml_002dedit_002dattrib_002dclear"></a>
</dd>
<dt><kbd>C-c C-k</kbd></dt>
<dd><p>Clear the value field
(<code>sgml-edit-attrib-clear</code>).
</p>
<a name="index-C_002dc-C_002dd-2"></a>
<a name="index-sgml_002dedit_002dattrib_002ddefault"></a>
</dd>
<dt><kbd>C-c C-d</kbd></dt>
<dd><p>Set the value field to ‘<samp>#DEFAULT</samp>’
(<code>sgml-edit-attrib-default</code>). This is a special value that will
make the attribute be implied.
</p></dd>
</dl>
<hr>
<a name="Change-and-delete"></a>
<div class="header">
<p>
Next: <a href="#Translating-characters-and-entities" accesskey="n" rel="next">Translating characters and entities</a>, Previous: <a href="#Attributes" accesskey="p" rel="prev">Attributes</a>, Up: <a href="#Edit" accesskey="u" rel="up">Edit</a> [<a href="Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Changing-and-deleting-markup"></a>
<h3 class="section">8.7 Changing and deleting markup</h3>
<dl compact="compact">
<dd><a name="index-C_002dc-_003d"></a>
<a name="index-sgml_002dchange_002delement_002dname"></a>
</dd>
<dt><kbd>C-c =</kbd></dt>
<dd><p>Change the name of the current element (<code>sgml-change-element-name</code>).
Tries to translate attribute specifications. An attribute will be
translated to an attribute with the same name. If the new element has
no attribute with the same name, the attribute will be ignored. If
there is an attribute with the same name but different declared content,
a warning is given.
</p>
<p>ID attributes are handled specially, an attribute with declared value ID
will always be translated to the attribute with declared value ID.
</p>
<a name="index-C_002dc-C_002dk-1"></a>
<a name="index-sgml_002dkill_002dmarkup"></a>
</dd>
<dt><kbd>C-c C-k</kbd></dt>
<dd><p>Kill next tag, markup declaration or process instruction
(<code>sgml-kill-markup</code>).
</p>
<a name="index-C_002dM_002dk"></a>
<a name="index-sgml_002dkill_002delement"></a>
</dd>
<dt><kbd>C-M-k</kbd></dt>
<dd><p>Kill the element following the cursor (<code>sgml-kill-element</code>).
</p>
<a name="index-C_002dc-_002d"></a>
<a name="index-sgml_002duntag_002delement"></a>
</dd>
<dt><kbd>C-c -</kbd></dt>
<dd><p>Remove tags from current element (<code>sgml-untag-element</code>).
</p>
<a name="index-C_002dc-_0023"></a>
<a name="index-sgml_002dmake_002dcharacter_002dreference"></a>
</dd>
<dt><kbd>C-c #</kbd></dt>
<dd><p>Convert character after point to a character reference
(<code>sgml-make-character-reference</code>). If called with a numeric
argument, convert a character reference back to a normal character.
</p>
<a name="index-C_002dc-C_002dq"></a>
<a name="index-sgml_002dfill_002delement"></a>
</dd>
<dt><kbd>C-c C-q</kbd></dt>
<dd><p>Fills an element as a paragraph (<code>sgml-fill-element</code>). This is a
substitute for the normal <code>fill-paragraph</code>. The command uses
heuristics to decide what should be a paragraph.
</p>
<ol>
<li> If point is in an element content, recursively fill the sub-elements.
</li><li> Find the biggest element with mixed content containing point.
</li><li> If the above element is mixed but contains elements with pure element
content then fill what is between the pure elements as paragraphs and
fill the pure elements recursively.
</li></ol>
<a name="index-sgml_002dexpand_002dall_002dshortrefs"></a>
</dd>
<dt><kbd>M-x sgml-expand-all-shortrefs</kbd></dt>
<dd><p>Short references to text entities are expanded to the replacement text
of the entity other short references are expanded into general entity
references. If argument, <var>to-entity</var>, is non-<code>nil</code>, or if
called interactive with numeric prefix argument, all short references
are replaced by generally entity references.
</p>
<a name="index-sgml_002dnormalize"></a>
</dd>
<dt><kbd>M-x sgml-normalize</kbd></dt>
<dd><p>Normalize the document in the buffer. This will
</p>
<ol>
<li> expand short references,
</li><li> insert missing tags,
</li><li> replace minimized tags with full tags,
</li><li> fix attribute specification lists according to options set.
</li></ol>
<p>There is one argument, <var>to-entity</var>, with the same meaning as for
<code>sgml-expand-all-shortrefs</code>.
</p>
<p>There is one option for the normalize command. With its default value,
normalize may actually change the data content of some elements. But
only by removing some white-space from the end of elements with omitted
end-tags.
</p></dd>
</dl>
<dl>
<dt><a name="index-sgml_002dnormalize_002dtrims"></a>User Option: <strong>sgml-normalize-trims</strong></dt>
<dd><p>If non-nil, <code>sgml-normalize</code> will trim off white space from end of
element when adding end-tag.
</p>
<p>Default: <code>t</code>.
</p></dd></dl>
<hr>
<a name="Translating-characters-and-entities"></a>
<div class="header">
<p>
Previous: <a href="#Change-and-delete" accesskey="p" rel="prev">Change and delete</a>, Up: <a href="#Edit" accesskey="u" rel="up">Edit</a> [<a href="Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Translating-between-characters-and-entity-references"></a>
<h3 class="section">8.8 Translating between characters and entity references</h3>
<p>Set the variable <code>sgml-display-char-list-filename</code> to a file that
contains mappings between all characters present in the presentation
character set, and their "standard replacement text" names, e.g. "å"
-> "[aring ]", e.t.c.
</p>
<p>The default value for this variable is ‘iso88591.map’.
</p>
<p>Then use the functions (also in the Modify menu)
</p>
<dl compact="compact">
<dd><a name="index-sgml_002dcharent_002dto_002ddisplay_002dchar"></a>
</dd>
<dt><code>sgml-charent-to-display-char</code></dt>
<dd><a name="index-sgml_002ddisplay_002dchar_002dto_002dcharent"></a>
</dd>
<dt><code>sgml-display-char-to-charent</code></dt>
</dl>
<p>to translate between entities and characters.
</p>
<hr>
<div class="header">
<p>
Previous: <a href="#Change-and-delete" accesskey="p" rel="prev">Change and delete</a>, Up: <a href="#Edit" accesskey="u" rel="up">Edit</a> [<a href="Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|