Perl6::Pod::FormattingCode::R - Replaceable item


Perl6-Pod documentation  | view source Contained in the Perl6-Pod distribution.

Index


NAME

Top

Perl6::Pod::FormattingCode::R - Replaceable item

SYNOPSIS

Top

    Then enter your details at the prompt:

    =for input
        Name: B<R<your surname>>
          ID: B<R<your employee number>>
        Pass: B<R<your 36-letter password>>

DESCRIPTION

Top

The R<> formatting code specifies that the contained text is a replaceable item, a placeholder, or a metasyntactic variable. It is used to indicate a component of a syntax or specification that should eventually be replaced by an actual value. For example:

    The basic C<ln> command is: C<ln> R<source_file> R<target_file>

or:

    Then enter your details at the prompt:

    =for input
        Name: R<your surname>
          ID: R<your employee number>
        Pass: R<your 36-letter password>

Typically replaceables would be rendered in fixed-width italics or with <var>...</var> tags. The font used should be the same as that used for the C<> code, unless the R<> is inside a K<> or T<> code (or the equivalent =input or =output blocks), in which case their respective fonts should be used.

to_xhtml

     Name: R<your surname>

Render xhtml:

     Name: <var>your surname</var>

to_docbook

     Name: R<your surname>

Render to

    Name: <replaceable>your surname</replaceable> 

http://www.docbook.org/tdg/en/html/replaceable.html =cut

sub to_docbook { my ( $self, $parser, @in ) = @_; my @content = $parser->_make_events(@in); $parser->mk_element('replaceable')->add_content(@content); }

1; __END__

SEE ALSO

Top

http://zag.ru/perl6-pod/S26.html, Perldoc Pod to HTML converter: http://zag.ru/perl6-pod/, Perl6::Pod::Lib

AUTHOR

Top

Zahatski Aliaksandr, <zag@cpan.org>

COPYRIGHT AND LICENSE

Top


Perl6-Pod documentation  | view source Contained in the Perl6-Pod distribution.