2010-07-03 2 views
4

Я хочу написать один файл Pod для perlop и perlopref. Моя кишка инстинкт должен сказать что-то вродеЕсть ли модуль Perl, который может разделить один файл основного файла Pod на несколько видов?

=head1 PRECEDENCE 

blah 

=head1 OPERATORS 

=head2 "X" 

=for short 

The double quote circumflex operator surrounds an interpolating string. 
See L<perlop/"X">. 

=for long 

-head3 Description 

blah blah blah 

-head3 Example 

blah blah blah 

-head3 See Also  

blah blah blah 

=head2 qq(X) 

=for short 

The generalized double quote circumflex operator surrounds an interpolating 
string. See L<perlop/qq(X)> 

=for long 

-head3 Description 

blah blah blah 

-head3 Example 

blah blah blah 

-head3 See Also  

blah blah blah 

и он производит (perlopref)

=head1 PRECEDENCE 

blah 

=head1 OPERATORS 

=head2 "X" 

The double quote circumflex operator surrounds an interpolating string. 
See L<perlop/"X">. 

=head2 qq(X) 

The double quote circumflex operator surrounds an interpolating string. 
See L<perlop/"X">. 

и (perlop)

=head1 PRECEDENCE 

blah 

=head1 OPERATORS 

=head2 "X" 

=head3 Description 

blah blah blah 

=head3 Example 

blah blah blah 

=head3 See Also  

blah blah blah 

=head2 qq(X) 

=head3 Description 

blah blah blah 

=head3 Example 

blah blah blah 

=head3 See Also  

blah blah blah 
+0

Мои чувства spidey говорят мне, что у нас будет больше вопросов о предмете здесь в течение следующего небольшого времени. :) – Ether

+0

Очень вероятно. –

ответ

4

Я не думаю, что это так, но я предложите пару мест, которые вы могли бы начать. Первый - это Pod::Inherit, который является инструментом, который DBIx :: Class использует для создания POD, который включает документацию унаследованных методов из суперклассов. Второй - Pod::Weaver, который является универсальным POD-плугом, используемым Dist :: Zilla, который имеет свой собственный характер конфигурации на основе правил и, вероятно, может делать то, что вам нужно без большой работы, - но это немного облегчает документацию прямо сейчас.