You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs-dev@perl.apache.org by Per Einar Ellefsen <pe...@skynet.be> on 2002/05/24 18:29:33 UTC

Re: cvs commit: modperl-docs/src/search make.pl .swishcgi.conf search_options

At 00:42 24.05.2002, moseley@apache.org wrote:
>
>   make.pl must be run befor generating any pages.
>   I'm not clear how (or if) Docset can do that automatically.

Could you please add the files generated by make.pl to CVS? We do that for 
the other files, because if not each person who wants to build the docs has 
to run the individual make.pl files.


-- 
Per Einar Ellefsen
per.einar@skynet.be



---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org


Re: cvs commit: modperl-docs/src/search make.pl .swishcgi.conf search_options

Posted by Per Einar Ellefsen <pe...@skynet.be>.
At 15:46 29.05.2002, Bill Moseley wrote:
>At 07:52 PM 05/29/02 +0800, Stas Bekman wrote:
> >> I guess Bill's point was that it's a CGI-executable dir, so we don't
> >> want any confusion about what is CGI and what not.
> >
> >that makes sense. In any case I've fixed that now.
>
>Is it a CGI-executable dir?  I'm using:
>
>deny from all
><files swish.cgi>
>    allow from all
>#   Options +ExecCGI
></files>
>
>But, of course, that depends on the server, and the server's config (e.g.
>if Options are allowed, etc.).

Yes, I knew that, but just meant that some files are *.pl and supposed to 
be executed by the server, while some only at build-time...

>Stas, I guess I need to add the files built by make.pl to CVS.  Seems
>awkward to me since I'm used to keeping only source in CVS, but since
>there's no "Makefile" type of struture to build dependencies I suppose they
>need to be in CVS.  In the pervious incarnation of Docset (pod2hpp?) I use
>a Makefile to build all dependencies first, and the Makefile then runs
>bin/build.

It'll be slightly easier this way.. As Stas said, we won't run make.pl too 
often anyway, so everything'll be ok.


-- 
Per Einar Ellefsen
per.einar@skynet.be



---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org


Re: cvs commit: modperl-docs/src/search make.pl .swishcgi.conf search_options

Posted by Stas Bekman <st...@stason.org>.
Bill Moseley wrote:
> At 07:52 PM 05/29/02 +0800, Stas Bekman wrote:
> 
>>>I guess Bill's point was that it's a CGI-executable dir, so we don't 
>>>want any confusion about what is CGI and what not.
>>
>>that makes sense. In any case I've fixed that now.
> 
> 
> Is it a CGI-executable dir?  I'm using:
> 
> deny from all
> <files swish.cgi>
>    allow from all
> #   Options +ExecCGI
> </files>
> 
> But, of course, that depends on the server, and the server's config (e.g.
> if Options are allowed, etc.).

In any case it's not copied now.

> Stas, I guess I need to add the files built by make.pl to CVS.  

I've done this already.

> Seems awkward to me since I'm used to keeping only source in CVS, but since
> there's no "Makefile" type of struture to build dependencies I suppose they
> need to be in CVS.  In the pervious incarnation of Docset (pod2hpp?) I use
> a Makefile to build all dependencies first, and the Makefile then runs
> bin/build.

I guess we can add this feature to DocSet. I'm not planning to do that 
any time soon, as I've too many other things to do. If anybody 
implements it, that would be cool. I'll add it to the TODO list.

As of this moment we just commit autogenerated things.

__________________________________________________________________
Stas Bekman            JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/     mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org   http://ticketmaster.com


---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org


Re: cvs commit: modperl-docs/src/search make.pl .swishcgi.conf search_options

Posted by Bill Moseley <mo...@hank.org>.
At 07:52 PM 05/29/02 +0800, Stas Bekman wrote:
>> I guess Bill's point was that it's a CGI-executable dir, so we don't 
>> want any confusion about what is CGI and what not.
>
>that makes sense. In any case I've fixed that now.

Is it a CGI-executable dir?  I'm using:

deny from all
<files swish.cgi>
   allow from all
#   Options +ExecCGI
</files>

But, of course, that depends on the server, and the server's config (e.g.
if Options are allowed, etc.).

Stas, I guess I need to add the files built by make.pl to CVS.  Seems
awkward to me since I'm used to keeping only source in CVS, but since
there's no "Makefile" type of struture to build dependencies I suppose they
need to be in CVS.  In the pervious incarnation of Docset (pod2hpp?) I use
a Makefile to build all dependencies first, and the Makefile then runs
bin/build.


-- 
Bill Moseley
mailto:moseley@hank.org

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org


Re: cvs commit: modperl-docs/src/search make.pl .swishcgi.conf search_options

Posted by Stas Bekman <st...@stason.org>.
Per Einar Ellefsen wrote:

>>>> How do I tell Docset not to copy make.pl to dst_html?
>>>
>>>
>>> In src/config.cfg we say to copy the whole search/ dir.
>>> Change this part in src/config.cfg (adding the make.pl line)
>>>     copy_skip => [
>>>         '(?:^|\/)CVS(?:\/|$)', # skip cvs control files
>>>         '#|~',                 # skip emacs backup files
>>>         'make\.pl',
>>>     ],
>>> I tested it, works correctly.
>>
>>
>> I guess it doesn't matter if it gets copied. Or do you feel strongly 
>> about not doing that?
> 
> 
> I guess Bill's point was that it's a CGI-executable dir, so we don't 
> want any confusion about what is CGI and what not.

that makes sense. In any case I've fixed that now.
__________________________________________________________________
Stas Bekman            JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/     mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org   http://ticketmaster.com


---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org


Re: cvs commit: modperl-docs/src/search make.pl .swishcgi.conf search_options

Posted by Per Einar Ellefsen <pe...@skynet.be>.
At 09:17 29.05.2002, Stas Bekman wrote:
>Thanks Bill for this change, I'll adjust the rest of the things, including 
>README.
>
>>> >>   make.pl must be run befor generating any pages.
>>> >>   I'm not clear how (or if) Docset can do that automatically.
>>> >
>>> >Could you please add the files generated by make.pl to CVS? We do that for
>>> >the other files, because if not each person who wants to build the 
>>> docs has
>>> >to run the individual make.pl files.
>>>
>>>Oh, sorry.  I misunderstood what make.pl was for.  I thought it would be
>>>part of the bin/build process.  I guess it's not a Makefile.
>>
>>Hmm, I wonder if DocSet should maybe start supporting this as a feature.. 
>>Or maybe not. We'll manage as is.
>
>No it shouldn't. You run make.pl infrequently and shouldn't be run every 
>time bin/build is run. If you want to run it from DocSet it should be 
>rewritten to support source modification control, so it'll be executed 
>only when things change. If you look at the existing make.pl files, they 
>are all very different, so it's not that simple to define dependency rules.
>
>Later if we feel a burning need for this we can add this feature.
>
>>>How do I tell Docset not to copy make.pl to dst_html?
>>
>>In src/config.cfg we say to copy the whole search/ dir.
>>Change this part in src/config.cfg (adding the make.pl line)
>>     copy_skip => [
>>         '(?:^|\/)CVS(?:\/|$)', # skip cvs control files
>>         '#|~',                 # skip emacs backup files
>>         'make\.pl',
>>     ],
>>I tested it, works correctly.
>
>I guess it doesn't matter if it gets copied. Or do you feel strongly about 
>not doing that?

I guess Bill's point was that it's a CGI-executable dir, so we don't want 
any confusion about what is CGI and what not.


-- 
Per Einar Ellefsen
per.einar@skynet.be



---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org


Re: cvs commit: modperl-docs/src/search make.pl .swishcgi.conf search_options

Posted by Stas Bekman <st...@stason.org>.
Thanks Bill for this change, I'll adjust the rest of the things, 
including README.

>> >>   make.pl must be run befor generating any pages.
>> >>   I'm not clear how (or if) Docset can do that automatically.
>> >
>> >Could you please add the files generated by make.pl to CVS? We do 
>> that for
>> >the other files, because if not each person who wants to build the 
>> docs has
>> >to run the individual make.pl files.
>>
>> Oh, sorry.  I misunderstood what make.pl was for.  I thought it would be
>> part of the bin/build process.  I guess it's not a Makefile.
> 
> 
> Hmm, I wonder if DocSet should maybe start supporting this as a 
> feature.. Or maybe not. We'll manage as is.

No it shouldn't. You run make.pl infrequently and shouldn't be run every 
time bin/build is run. If you want to run it from DocSet it should be 
rewritten to support source modification control, so it'll be executed 
only when things change. If you look at the existing make.pl files, they 
are all very different, so it's not that simple to define dependency rules.

Later if we feel a burning need for this we can add this feature.

>> How do I tell Docset not to copy make.pl to dst_html?
> 
> 
> In src/config.cfg we say to copy the whole search/ dir.
> 
> Change this part in src/config.cfg (adding the make.pl line)
> 
>     copy_skip => [
>         '(?:^|\/)CVS(?:\/|$)', # skip cvs control files
>         '#|~',                 # skip emacs backup files
>         'make\.pl',
>     ],
> 
> I tested it, works correctly.

I guess it doesn't matter if it gets copied. Or do you feel strongly 
about not doing that?

__________________________________________________________________
Stas Bekman            JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/     mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org   http://ticketmaster.com


---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org


Re: cvs commit: modperl-docs/src/search make.pl .swishcgi.conf search_options

Posted by Per Einar Ellefsen <pe...@skynet.be>.
At 18:39 24.05.2002, Bill Moseley wrote:
>At 06:29 PM 05/24/02 +0200, Per Einar Ellefsen wrote:
> >At 00:42 24.05.2002, moseley@apache.org wrote:
> >>
> >>   make.pl must be run befor generating any pages.
> >>   I'm not clear how (or if) Docset can do that automatically.
> >
> >Could you please add the files generated by make.pl to CVS? We do that for
> >the other files, because if not each person who wants to build the docs has
> >to run the individual make.pl files.
>
>Oh, sorry.  I misunderstood what make.pl was for.  I thought it would be
>part of the bin/build process.  I guess it's not a Makefile.

Hmm, I wonder if DocSet should maybe start supporting this as a feature.. 
Or maybe not. We'll manage as is.

>How do I tell Docset not to copy make.pl to dst_html?

In src/config.cfg we say to copy the whole search/ dir.

Change this part in src/config.cfg (adding the make.pl line)

     copy_skip => [
         '(?:^|\/)CVS(?:\/|$)', # skip cvs control files
         '#|~',                 # skip emacs backup files
         'make\.pl',
     ],

I tested it, works correctly.


-- 
Per Einar Ellefsen
per.einar@skynet.be



---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org


Re: cvs commit: modperl-docs/src/search make.pl .swishcgi.conf search_options

Posted by Bill Moseley <mo...@hank.org>.
At 06:29 PM 05/24/02 +0200, Per Einar Ellefsen wrote:
>At 00:42 24.05.2002, moseley@apache.org wrote:
>>
>>   make.pl must be run befor generating any pages.
>>   I'm not clear how (or if) Docset can do that automatically.
>
>Could you please add the files generated by make.pl to CVS? We do that for 
>the other files, because if not each person who wants to build the docs has 
>to run the individual make.pl files.

Oh, sorry.  I misunderstood what make.pl was for.  I thought it would be
part of the bin/build process.  I guess it's not a Makefile.

How do I tell Docset not to copy make.pl to dst_html?


-- 
Bill Moseley
mailto:moseley@hank.org

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org