Rechercher une page de manuel

Chercher une autre page de manuel:

paf.1p

Langue: en

Autres versions - même langue

Version: 2010-01-03 (ubuntu - 24/10/10)

Section: 1 (Commandes utilisateur)

NAME

paf - Pod Abstract Filter. Transform Pod documents from the command line.

SYNOPSIS

  sh$>
   paf summary /usr/bin/paf
   paf add_podcmds SomeModule.pm
   paf sort -heading=METHODS Pod/Abstract/Node.pm # METHODS is default
   paf sort summary Pod/Abstract/Node.pm
   
   # See Pod::Abstract::Filter::overlay
   paf overlay sort cut clear_podcmds SomeClass.pm
   
   # -p will emit pod source, instead of spawning perldoc.
   paf -p sort Pod::Abstract::Node
   paf -p find hoist Pod::Abstract::Node
 
 

DESCRIPTION

Paf is a small but powerful, modular Pod filter and transformation tool. It allows full round-trip transformation of Pod documents using the Pod::Abstract library, with multiple filter chains without having to serialise/re-parse the document at each step.

Paf comes with a small set of useful filters, but can be extended by simply writing new classes in the "Pod::Abstract::Filter" namespace.

FILTERS

add_podcmds

Add explicit =pod commands at the end of each cut section, so that all pod sections are started with an =pod command.

clear_podcmds

Remove all =pod commands that are not ending cut blocks. This will clean up documents that have been reduced using the "cut" filter too.

cut

Remove all cut nodes, so that only the pod remains.

overlay

  paf overlay Source.pm
 
 

For overlay to work, there must be a "begin :overlay/end :overlay" section in the Source file, with "=overlay SECTION Module" definitions inside. The net effect is that any missing subheadings in SECTION are added from the same section in the specified Modules.

Note that this will overlay the whole subheading, INCLUDING CUT NODES, so it can add code to the source document. Use "cut" if you don't want this.

Each overlaid section will include a "=for overlay from" marker, so that it can be replaced by a subsequent overlay from the same file/module. These sections will be replaced in-place, so ordering of sections once first overlaid will be preserved.

unoverlay

  paf unoverlay Source.pm
 
 

Strips all sections marked as overlaid and matching the overlay spec from the source.

sort

  paf sort [-heading=METHODS] Source.pm
 
 

Sort all of the subheadings in the named heading (METHODS if not provided).

This will move cut nodes around with their headings, so your code will mutate. Use "cut" if you only want pod in the output.

Alternatively, you can also cause sorting of headings to occur by including "=for sorting" at the start of your section (before the first subheading).

summary

Provide an abbreviated summary of the document. If there is a verbatim node in the body of a heading containing the heading name, it will be considered an example and expanded as part of the summary.

find

  paf find [-f=]name Source.pm
 
 

Find specific sub-sections or list items mentioning name. Used to restrict a larger document down to a smaller set that you're interested in. If no -f is specified, then the word following find will be the search term.

uncut

  paf uncut Source.pm
 
 

Convert cut nodes in the source into verbatim text. Not the inverse of cut!

number_sections

  paf number_sections Source.pm
 
 

Applies simple multipart (3.1.2) section numbering to head1 through head4 headings.

Note that number_sections will currently stuff up some of the cleverness in things like summary, as the section names won't match function names any more.

Je ne compte pas mettre la société en bourse. Pas d'actionnaires.
La bourse pour moi, c'est de l'argent fictif. Il n'est pas
normal que je prenne ce 'racourci' qui me donnerait en quelques
jours des milliards grâce à ma cote qui monterait au début,
qui resterait stable et qui me foutrait sur la paille 5 ans
après, sans crier gare, comme c'est le cas aujourd'hui
avec toutes ces sociétés qui font faillites, ou de ces
présidents qui ne le sont plus parce que des associés se sont
joints et possèdent maintenant 51% de la société en actions
et donc le pouvoir. Au lieu de me mettre en bourse, je vais
investir dans l'immobilier. Chaque employé engagé dans la
société sera responsable de 5 locataires louant un appart
à 500 Euros par mois. Ceci donne 500 Euros * 5 = 2500 Euros/mois.
c'est à dire, le salaire de cet employé. L'employé sera
donc payé avec l'argent de ses loyés, ce qui évite qu'il ne
soit viré si la société est dans une mauvaise passe, puisque
de toute façon, ses appartements "assurent" cet employé et
pour être franc, chez moi on ne parlera pas d'employés mais
d'agents parce qu'un employé, ca ressemble trop à du bétail.
Je veux les appeler des agents, et leur laisser la possibilité
de créer des sous-sociétés à ma future société mère, ou leur
laisser la possiblité de travailler dans un secteur différent
de la société chaque fois qu'ils le souhaiteraient. La société
a une sous-société sur le vin parce qu'un agent a eu la
bonne idée de la créer ? Eh ben pourquoi ne pas le rejoindre !
Si chaque agent peut "changer" son métier tout en restant
dans la même société, il obtient toujours des "points"
d'ancienneté et est donc de plus en plus payé/augmenté
et connaît de plus en plus comment fonctionne la société mère.
Pourquoi attendre d'avoir 40 ans pour créer sa société et
pourquoi travailler jusqu'à tes 40 ans pour avoir l'argent
nécessaire à la création de ta société alors que finalement,
tes idées, tu les as déjà, tout ce qu'il te faut, c'est
quelqu'un qui croit en toi. Ma société mère pourrait croire
en toi par exemple ( une fois qu'elle sera là tout de même )
et pourrait te donner le financement nécessaire. Pourquoi
dire aux jeunes d'aujourd'hui "arrête de rêver" ? C'est en
rêvant qu'on arrive. Regarde moi ! Tu crois que MultiDeskOS
est né d'hier ? Certainement pas ! Le premier système que
j'ai créé ( et qui était finalement la base de MultiDeskOS )
était ce système domotique JSI connecté au joystick et
je n'avais alors que 16 ans ! Tu te rend compte ! Presque 10
ans que je pourrais avoir ma société ou ma sous-société si
quelqu'un avait cru en moi. Je veux donc de mon coté, assurer
mes agents pour qu'ils ne doivent jamais être virés et
leur permettre de faire un peu de tout et n'importe quoi,
tout en gardant disons 70% d'activité pour la société mère,
en tout cas dans un premier temps. Sa sous société fait
faillite sur le vin parce que ca n'intéresse pas les gens ?
Pas de problème ! On supprime simplement cette sous-société
et on transfère les agents qui travaillaient dedans dans une
autre sous-société ou on les transfère dans la société mère
pour qu'ils retrouvent de nouvelles idées MAIS ILS
NE SONT JAMAIS VIRES ! S'auf s'ils font des conneries
et qu'ils le savent, alors là, je les fou dehors pour
assurer la stabilité des autres agents. Enfin voilà.
-- Jayce - Social. --