doc/emacs/text.texi

94 @table @kbd
108 @end table
165 the syntax table.  Any character can, for example, be declared to be a
181 @table @kbd
190 @end table
263 @table @kbd
270 @end table
348 @table @kbd
359 @end table
507 @table @kbd
513 @end table
566 @table @kbd
577 @end table
675 @table @kbd
686 @end table
834 @table @kbd
845 @end table
915 you explicitly invoke them.  It changes the syntax table so that
938 This command performs completion of the partial word in the buffer
1094 @table @kbd
1120 @end table
1140 @table @kbd
1174 @end table
1338 @table @asis
1372 @end table
1624 @table @kbd
1638 @end table
1702 @table @kbd
1709 @end table
1721 the usual completion commands (@pxref{Completion}).  The default
1722 completion list contains the standard @LaTeX{} block types.  If you
1723 want additional block types for completion, customize the list
1745 @table @kbd
1774 @end table
1931 select your desired compilation program using the standard completion
1966 @findex sgml-mode
1979 @table @kbd
1982 @findex sgml-name-char
1984 @samp{&}-command for that character (@code{sgml-name-char}).
1988 @findex sgml-tag
1989 Interactively specify a tag and its attributes (@code{sgml-tag}).
2002 @findex sgml-attributes
2004 (@code{sgml-attributes}).
2008 @findex sgml-skip-tag-forward
2010 through its corresponding closing tag) (@code{sgml-skip-tag-forward}).
2015 @findex sgml-skip-tag-backward
2018 (@code{sgml-skip-tag-backward}).  A numeric argument acts as a repeat
2023 @findex sgml-delete-tag
2025 (@code{sgml-delete-tag}).  If the tag at or after point is an opening
2031 @findex sgml-tag-help
2033 (@code{sgml-tag-help}).  If the argument @var{tag} is empty, describe
2038 @findex sgml-close-tag
2040 (@code{sgml-close-tag}).  If called within a tag or a comment,
2045 @findex sgml-name-8bit-mode
2048 characters themselves (@code{sgml-name-8bit-mode}).
2052 @findex sgml-validate
2054 buffer as SGML (@code{sgml-validate}).  (In HTML mode this key
2059 @findex sgml-tags-invisible
2061 used as a cheap preview (@code{sgml-tags-invisible}).
2062 @end table
2071 and use them to provide completion of XML elements via
2089 @vindex sgml-xml-mode
2092 existing buffer, type @kbd{M-x sgml-mode}.  On enabling SGML mode,
2094 sets the variable @code{sgml-xml-mode} to a non-@code{nil} value.
2120 @table @kbd
2129 @end table
2260 @table @code
2287 @end table
2301 @table @kbd
2340 @end table
2370 @table @code
2387 @end table
2419 @table @kbd
2449 @end table
2492 @cindex table mode
2495   The @code{table} package provides commands to easily edit text-based
2496 tables.  Here is an example of what such a table looks like:
2514   When Emacs recognizes such a stretch of text as a table
2515 (@pxref{Table Recognition}), editing the contents of each table cell
2516 will automatically resize the table, whenever the contents become too
2518 following sections for navigating and editing the table layout.
2520 @findex table-fixed-width-mode
2521   Type @kbd{M-x table-fixed-width-mode} to toggle the automatic table
2525 * Table Definition::          What is a text based table.
2526 * Table Creation::            How to create a table.
2528 * Cell Commands::             Cell-oriented commands in a table.
2539   A @dfn{table} consists of a rectangular text area which is divided
2547 @table @code
2548 @vindex table-cell-vertical-char
2549 @item table-cell-vertical-char
2552 @vindex table-cell-horizontal-chars
2553 @item table-cell-horizontal-chars
2556 @vindex table-cell-intersection-char
2557 @item table-cell-intersection-char
2560 @end table
2590 @cindex create a text-based table
2591 @cindex table creation
2593 @findex table-insert
2594   To create a text-based table from scratch, type @kbd{M-x
2595 table-insert}.  This command prompts for the number of table columns,
2596 the number of table rows, cell width and cell height.  The cell width
2600 commas (which specify the width/height of the individual table
2601 columns/rows, counting from left to right for table columns and from
2602 top to bottom for table rows).  The specified table is then inserted
2605   The table inserted by @kbd{M-x table-insert} contains special text
2607 table.  If you save the buffer to a file and visit it again later,
2608 those properties are lost, and the table appears to Emacs as an
2610 back into a table.
2614 @cindex table recognition
2616 @findex table-recognize
2617 @findex table-unrecognize
2619 properties applied by @kbd{M-x table-insert}, are not treated
2621 table-recognize}.  This command scans the current buffer,
2622 @dfn{recognizes} valid table cells, and applies the relevant text
2623 properties.  Conversely, type @kbd{M-x table-unrecognize} to
2630 @table @kbd
2631 @findex table-recognize-region
2632 @item M-x table-recognize-region
2635 @findex table-unrecognize-region
2636 @item M-x table-unrecognize-region
2639 @findex table-recognize-table
2640 @item M-x table-recognize-table
2641 Recognize the table at point and activate it.
2643 @findex table-unrecognize-table
2644 @item M-x table-unrecognize-table
2645 Deactivate the table at point.
2647 @findex table-recognize-cell
2648 @item M-x table-recognize-cell
2651 @findex table-unrecognize-cell
2652 @item M-x table-unrecognize-cell
2654 @end table
2656   @xref{Table Conversion}, for another way to recognize a table.
2661 @findex table-forward-cell
2662 @findex table-backward-cell
2663   The commands @kbd{M-x table-forward-cell} and @kbd{M-x
2664 table-backward-cell} move point from the current cell to an adjacent
2665 cell.  The order is cyclic: when point is in the last cell of a table,
2666 @kbd{M-x table-forward-cell} moves to the first cell.  Likewise, when
2667 point is on the first cell, @kbd{M-x table-backward-cell} moves to the
2670 @findex table-span-cell
2671   @kbd{M-x table-span-cell} prompts for a direction---right, left,
2676 @findex table-split-cell
2677 @findex table-split-cell-vertically
2678 @findex table-split-cell-horizontally
2680 @cindex splitting table cells
2681   @kbd{M-x table-split-cell} splits the current cell vertically or
2684 table-split-cell-vertically} and @kbd{M-x
2685 table-split-cell-horizontally}.  When splitting vertically, the old
2697 @table @kbd
2698 @findex table-heighten-cell
2699 @item M-x table-heighten-cell
2702 @findex table-shorten-cell
2703 @item M-x table-shorten-cell
2706 @findex table-widen-cell
2707 @item M-x table-widen-cell
2710 @findex table-narrow-cell
2711 @item M-x table-narrow-cell
2713 @end table
2719   The command @kbd{M-x table-justify} imposes @dfn{justification} on
2720 one or more cells in a text-based table.  Justification determines how
2722 Each cell in a table can be separately justified.
2724 @findex table-justify
2725   @kbd{M-x table-justify} first prompts for what to justify; the
2727 cells in the current table column) and @samp{row} (all cells in the
2728 current table row).  The command then prompts for the justification
2735 instance, you can call @kbd{M-x table-justify} twice, once to specify
2739 @vindex table-detect-cell-alignment
2742 table recognition commands, such as @kbd{M-x table-recognize}
2745 this feature, change the variable @code{table-detect-cell-alignment}
2752 @findex table-insert-row
2753   @kbd{M-x table-insert-row} inserts a row of cells before the current
2754 table row.  The current row, together with point, is pushed down past
2756 table, invoke this command with point below the table, just below the
2762 @findex table-insert-column
2763   Similarly, @kbd{M-x table-insert-column} inserts a column of cells
2764 to the left of the current table column.  To insert a column to the
2766 the right of the rightmost column, outside the table.  A numeric
2770   @kbd{M-x table-delete-column} deletes the column of cells at point.
2771 Similarly, @kbd{M-x table-delete-row} deletes the row of cells at
2777 @cindex text to table
2778 @cindex table to text
2780 @findex table-capture
2781   The command @kbd{M-x table-capture} captures plain text in a region
2782 and turns it into a table.  Unlike @kbd{M-x table-recognize}
2784 table appearance; it only needs to have a logical table-like
2797 Invoking @kbd{M-x table-capture} on that text produces this table:
2809 @findex table-release
2810   @kbd{M-x table-release} does the opposite: it converts a table back
2817 table-capture is a powerful command.
2822                    extracts cell items into a table.
2826 Applying @code{table-capture} to a region containing the above text,
2828 table with a single cell like the following one.
2833 |table-capture is a powerful command.                      |
2838 |                   extracts cell items into a table.      |
2845 subdivide the table so that each paragraph occupies a cell:
2849 |table-capture is a powerful command.                      |
2854 |                 | extracts cell items into a table.      |
2860 of other cells.  When finished, we can invoke @kbd{M-x table-release}
2861 to convert the table back to plain text.
2866 @cindex table dimensions
2867 @findex table-query-dimension
2868   The command @code{table-query-dimension} reports the layout of the
2869 table and table cell at point.  Here is an example of its output:
2877 high, the table is 67 characters wide and 16 lines high with 2 columns
2880 @findex table-insert-sequence
2881   @kbd{M-x table-insert-sequence} traverses the cells of a table
2890 @cindex table for HTML and LaTeX
2891 @findex table-generate-source
2892   @kbd{M-x table-generate-source} generates a table formatted for a
2896 and a table caption, and then inserts the generated table into the
2898 @code{table.@var{lang}}, where @var{lang} is the language you
2911 @table @asis
2947 @end table