GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
RTF::Control(3) User Contributed Perl Documentation RTF::Control(3)

RTF::Control - Application of RTF::Parser for document conversion

version 1.12

Application of RTF::Parser for document conversion

RTF::Control is a sublass of RTF::Parser. RTF::Control can be seen as a helper module for people wanting to write their own document convertors - RTF::HTML::Convertor and RTF::TEXT::Convertor both subclass it.

I am the new maintainer of this module. My aim is to keep the interface identical to the old interface while cleaning up, documenting, and testing the internals. There are things in the interface I'm unhappy with, and things I like - however, I'm maintaining rather than developing the module, so, the interface is mostly frozen.

For starters, go and look at the source of RTF::TEXT::Convertor

Except for RTF::Parser subs, the following is a list of variables exported by RTF::Control that you're expected to tinker with in your own subclass.

If you read the docs of RTF::Parser you'll see that you can redefine some subs there - RTF::Control has its own definitions for all of these, but you might want to over-ride "symbol()", "text()", and "char()". We'll look at what the defaults of each of these do, and what you need to do if you want to override any of them a little further down.

This hash is actually merged into %do_on_control, with the value wrapped in a subroutine that effectively says "print shift". You can put any control words that should map directly to a certain output in here - "\tab", for example could be "$symbol{'tab'} = "\t"".

This hash gets filled with document meta-data, as per the RTF specification.

Not really sure, but paragraph properties

%do_on_control tells us what to do when we meet a specific control word. The values are coderefs. %do_on_event also holds coderefs, but these are more abstract things to do, say when the stylesheet changes. %do_on_event thingies tend to be called by %do_on_control thingies, as far as I can tell.

Style is the current style, $newstyle is the one we're about to change to if we're about to change...

Current event

Pending text

Returns an RTF::Control object. RTF::Control is a subclass of RTF::Parser. Internally, we call RTF::Parser's new() method, and then we call an internal method called _configure(), which takes care of options we were passed.

ADD STUFF ON -output AND -confdir

I'm leaving this method in because removing it will cause a backward-compatability nightmare. This method returns the ( wait for it ) path that the .pm file corresponding to the class that the object is contained, without a trailing semi-colon. Obviously this is nasty in several ways. If you've set "-confdir" in "new()" that will be returned instead. You should definitely take that route if you're on an OS on which Perl can't use / as a directory seperator.

This nicely abstracts away using application_dir and so on. It's a method call. It'll take the name of the class, and an argument for the module/file it's looking for. This is likely to be 'ansi' or 'charmap'. This argument, for historical reasons (ho ho ho) will have any _'s removed in the check for a module name ... " $self-"charmap_reader('char_map') > will thus look for, for example, " RTF::TEXT::charmap " to load. It'll return the data in the file as an array of lines. This description sucks.

Serializes and prints the stack to STDERR

Holder routine for the current thing to do with output text we're given. It starts off as the same as $string_output_sub, which adds the string to the element at the "TOP" of the output stack. However, the idea, I believe, is to allow that to be changed at will, using "push_output".

Adds a blank element to the end of the stack. It will change (or maintain) the function of "output" to be $string_output_sub, unless you pass it the argument 'nul' , in which case it will set "output" to be $nul_output_sub.

Removes and returns the last element of the ouput stack

Only called at init time, is a method call not a function. Sets the action of "flush_top_output", depending on whether you pass it a filehandle or string reference.

Output the top element of the stack in the way specified by the call to "set_top_output_to"

Hey! The above document had some coding errors, which are explained below:
Around line 35:
Deleting unknown formatting code M<>
2014-04-20 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.