File: Texinfo-ManipulateTree.texi

package info (click to toggle)
texinfo 7.2-5
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 113,148 kB
  • sloc: perl: 1,281,149; ansic: 135,801; sh: 12,218; xml: 9,069; makefile: 4,016; javascript: 1,923; awk: 1,889; sed: 78; pascal: 65
file content (105 lines) | stat: -rw-r--r-- 4,120 bytes parent folder | download | duplicates (2)
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
@node Texinfo@asis{::}ManipulateTree
@chapter Texinfo::ManipulateTree

@node Texinfo@asis{::}ManipulateTree NAME
@section Texinfo::ManipulateTree NAME

Texinfo::ManipulateTree - Texinfo modules common tree manipulation functions

@node Texinfo@asis{::}ManipulateTree SYNOPSIS
@section Texinfo::ManipulateTree SYNOPSIS

@verbatim
  use Texinfo::ManipulateTree;
@end verbatim

@node Texinfo@asis{::}ManipulateTree NOTES
@section Texinfo::ManipulateTree NOTES

The Texinfo Perl module main purpose is to be used in @code{texi2any} to convert
Texinfo to other formats.  There is no promise of API stability.

@node Texinfo@asis{::}ManipulateTree DESCRIPTION
@section Texinfo::ManipulateTree DESCRIPTION

@code{Texinfo::ManipulateTree} contains methods for copying and modifying the
Texinfo tree used for default conversion to output formats.

For optional tree transformation, see @ref{Texinfo@asis{::}Transformations NAME,, Texinfo::Transformations}.

@node Texinfo@asis{::}ManipulateTree METHODS
@section Texinfo::ManipulateTree METHODS

The Texinfo tree and Texinfo tree elements used in argument of some functions
are documented in @ref{Texinfo@asis{::}Parser TEXINFO TREE}.  When customization
information is needed, an object that defines @code{get_conf} is
expected, normally a @ref{Texinfo@asis{::}Document Getting customization
options values registered in document} object.

@table @asis
@item move_index_entries_after_items_in_tree($tree)
@anchor{Texinfo@asis{::}ManipulateTree move_index_entries_after_items_in_tree($tree)}
@cindex @code{move_index_entries_after_items_in_tree}

In @code{@@enumerate} and @code{@@itemize} from the tree, move index entries
appearing just before @code{@@item} after the @code{@@item}.  Comment lines
between index entries are moved too.

@item protect_colon_in_tree($tree)
@anchor{Texinfo@asis{::}ManipulateTree protect_colon_in_tree($tree)}

@item protect_node_after_label_in_tree($tree)
@anchor{Texinfo@asis{::}ManipulateTree protect_node_after_label_in_tree($tree)}
@cindex @code{protect_colon_in_tree}
@cindex @code{protect_node_after_label_in_tree}

Protect colon with @code{protect_colon_in_tree} and characters that
are special in node names after a label in menu entries (tab
dot and comma) with @code{protect_node_after_label_in_tree}.
The protection is achieved by putting protected characters
in @code{@@asis@{@}}.

@item protect_comma_in_tree($tree)
@anchor{Texinfo@asis{::}ManipulateTree protect_comma_in_tree($tree)}
@cindex @code{protect_comma_in_tree}

Protect comma characters, replacing @code{,} with @@comma@{@} in tree.

@item protect_first_parenthesis($element)
@anchor{Texinfo@asis{::}ManipulateTree protect_first_parenthesis($element)}
@cindex @code{protect_first_parenthesis}

Modify @emph{$element} contents by protecting the first parenthesis.
If @emph{$element} is undef a fatal error with a backtrace will be emitted.

@item relate_index_entries_to_table_items_in_tree($document)
@anchor{Texinfo@asis{::}ManipulateTree relate_index_entries_to_table_items_in_tree($document)}
@cindex @code{relate_index_entries_to_table_items_in_tree}

In tables, relate index entries preceding and following an
entry with said item.  Reference one of them in the entry's
@code{entry_associated_element}.

@end table

@node Texinfo@asis{::}ManipulateTree SEE ALSO
@section Texinfo::ManipulateTree SEE ALSO

@ref{Texinfo@asis{::}Document NAME,, Texinfo::Document}, @ref{Texinfo@asis{::}Structuring NAME,, Texinfo::Structuring}, @ref{Texinfo@asis{::}Transformations NAME,, Texinfo::Transformations}.

@node Texinfo@asis{::}ManipulateTree AUTHOR
@section Texinfo::ManipulateTree AUTHOR

Patrice Dumas, <pertusus@@free.fr>

@node Texinfo@asis{::}ManipulateTree COPYRIGHT AND LICENSE
@section Texinfo::ManipulateTree COPYRIGHT AND LICENSE

Copyright 2010- Free Software Foundation, Inc.  See the source file for
all copyright years.

This library is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or (at
your option) any later version.