SPUG: POD Talk

[Geoffrey & Kristin Grosenbach]

By popular demand and at the request of Tim, I will be giving a short 
talk on the use of POD at the February SPUG meeting.

Planned topics include:

* Basic POD tags and syntax
* Making pod2html look good with stylesheets
* Targeting multiple output formats
* Syntax/parser gotchas
* A brief look at the code that parses POD (i.e. writing your own 
translator for a new or customized output format)

Feel free to write me with any other POD-related topics you'd like to 
hear discussed.

Geoff
glyph at mac.com


On Thursday, January 2, 2003, at 10:03  AM, Christie 'Bob' Robertson 
wrote:

> Hey, I'd love a talk on your ways to use POD!  Ask Tim about it?
> Christie
>
>
> On Sat, 28 Dec 2002, Geoffrey & Kristin Grosenbach wrote:
>
>> On Friday, December 27, 2002, at 12:26  PM, Brian Hatch wrote:
>>>
>>> If you are writing code that is only used by your employer, then
>>> increased obfuscation can lead to a good situation called "job
>>> security".
>>
>> *cold chill creeps up the back of my neck*
>>
>> In the Tao of Programming it is written:
>>
>> "Though a program be but three lines long, someday it will have to be
>> maintained."
>>
>>
>> I've spent the last month rewriting a whole Perl-based system because 
>> it
>> was so obfuscated. (Okay, it was also failing to fulfill the purposes
>> for which it was originally written, but obfuscation was one of the
>> reasons for the rewrite). The people before me had either left with
>> short notice, or were fired. I'm not hoping to lose my job, but I do
>> hope to leave a better system for those who follow by documenting and
>> using readable code (which often uses short variable names, but with
>> comments).
>>
>> And what about POD? I'm surprised at how many Perl programmers I meet
>> who don't know anything about POD (maybe I should volunteer to give a
>> lightning talk on my favorite ways to use POD). It may not be as
>> automatic as JavaDoc or some other in-code documentation systems, but
>> it's built into the Perl interpreter and there are a lot of translators
>> that can work with it.
>>
>> A friend of mine says:
>>
>> "A good programmer can recognize well-written code from 50 feet away."
>>
>> (He must have really good eyesight).
>>
>>
>> Geoff

http://www.GeoffreyGrosenbach.com
>>
>>
>>  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
>> - - -
>>      POST TO: spug-list at pm.org       PROBLEMS: owner-spug-list at pm.org
>>       Subscriptions; Email to majordomo at pm.org:  ACTION  LIST  EMAIL
>>   Replace ACTION by subscribe or unsubscribe, EMAIL by your 
>> Email-address
>>  For daily traffic, use spug-list for LIST ;  for weekly, 
>> spug-list-digest
>>      Seattle Perl Users Group (SPUG) Home Page: http://seattleperl.org
>>
>>
>


 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
     POST TO: spug-list at pm.org       PROBLEMS: owner-spug-list at pm.org
      Subscriptions; Email to majordomo at pm.org:  ACTION  LIST  EMAIL
  Replace ACTION by subscribe or unsubscribe, EMAIL by your Email-address
 For daily traffic, use spug-list for LIST ;  for weekly, spug-list-digest
     Seattle Perl Users Group (SPUG) Home Page: http://seattleperl.org