[wwwdocs patch] mention cygport as "method three"

[wwwdocs patch] mention cygport as "method three"

[Brian Dessent]

[-- Attachment #1: Type: text/plain, Size: 103 bytes --]


This is a patch for <http://cygwin.com/setup.html> to officially mention
cygport as acceptible.

Brian

[-- Attachment #2: cygwin_setup_cygport.patch --]
[-- Type: text/plain, Size: 3221 bytes --]

2008-04-08  Brian Dessent  <brian@dessent.net>

	* setup.html: Mention cygport as method three.

Index: setup.html
===================================================================
RCS file: /cvs/cygwin/htdocs/setup.html,v
retrieving revision 1.105
diff -u -p -r1.105 setup.html
--- setup.html	26 Sep 2007 09:42:02 -0000	1.105
+++ setup.html	9 Apr 2008 03:24:38 -0000
@@ -362,7 +362,7 @@ etc...
 	<li>Ensure that your package handles binary only systems, textmode only systems, and hybrid systems correctly. </li>
       </ul>
       <h2><a id="srcpackage_contents" name="srcpackage_contents">Package Source</a></h2>
-      <p>There are two accepted ways to package the source code for Cygwin packages.</p>
+      <p>There are three accepted ways to package the source code for Cygwin packages.</p>
       <h3>Method One</h3>
       <ul class="spaced">
 	<li>
@@ -420,6 +420,7 @@ boffo-1.0-1/CYGWIN-PATCHES/setup.hint
 	</li>
       </ul>
       <h3>Method Two</h3>
+      <p>This method is sometimes referred to as the "g-b-s" method, after the filename of the <a href="http://sourceware.org/cgi-bin/cvsweb.cgi/~checkout~/packaging/templates/generic-build-script?content-type=text/plain&amp;cvsroot=cygwin-apps"><tt>generic-build-script</tt></a> template.</p>
       <ul class="spaced">
 	<li>In a packaging technique inspired by rpms and debs, you may create a -src tarball which simply contains:
 	  <ol>
@@ -466,6 +467,10 @@ tar xvjf ~/sources/boffo-1.0-1-src.tar.b
 	  </ul>
 	</li>
       </ul>
+      <h3>Method Three: cygport</h3>
+      <p>The technique of method two became popular to many maintainers, however it suffers from a number of drawbacks when applied on a wide scale.  The <tt>cygport</tt> <a href="http://cygwin-ports.cvs.sourceforge.net/*checkout*/cygwin-ports/cygport/README">README</a> explains a number of these problems.</p>
+      <p>The <tt>cygport</tt> framework is a response to these issues, and borrows concepts from the Gentoo portage system.  It separates the g-b-s into a small file containing the package-specific parts and moves the main script infrastructure into shared files.  For more information on using <tt>cygport</tt> consult the documentation and sample port files.</p>
+      <p>Source packages created with <tt>cygport</tt> have a similar structure to those created with method two, except that they contain a '<tt>boffo-1.0-1.cygport</tt>' file in place of the '<tt>boffo-1.0-1.sh</tt>' script.  The binary package is built by running '<tt>cygport boffo-1.0-1 all</tt>' instead of '<tt>./boffo-1.0-1.sh all</tt>', and so on for <tt>prep</tt>, <tt>compile</tt>, <tt>package</tt>, <tt>finish</tt>, etc.</p>
       <h2><a id="postinstall" name="postinstall">Creating a package postinstall script</a></h2>
       <p>If your package requires certain commands to be executed after the files in the package are installed, include them in a file in the package called /etc/postinstall/<var>package</var>.sh or /etc/postinstall/<var>package</var>.bat.</p>
       <p>If the file's name ends in ".sh", it is executed with the Cygwin shell; if it ends in ".bat", it is executed with the DOS command interpreter. If it doesn't end with either of these suffixes, it is ignored.</p>

Re: [wwwdocs patch] mention cygport as "method three"

[Corinna Vinschen]

On Apr  8 20:27, Brian Dessent wrote:
> 
> This is a patch for <http://cygwin.com/setup.html> to officially mention
> cygport as acceptible.

Thanks, please apply.


Corinna


-- 
Corinna Vinschen                  Please, send mails regarding Cygwin to
Cygwin Project Co-Leader          cygwin AT cygwin DOT com
Red Hat

Re: [wwwdocs patch] mention cygport as "method three"

[Brian Dessent]

Corinna Vinschen wrote:

> Thanks, please apply.

I checked in the change a day or two ago
(http://sourceware.org/cgi-bin/cvsweb.cgi/htdocs/setup.html?cvsroot=cygwin)
but the live copy (http://www.cygwin.com/setup.html) still has not
updated.  Is the automatic trigger script broken?

Brian

Re: [wwwdocs patch] mention cygport as "method three"

[Corinna Vinschen]

On Apr 10 23:04, Brian Dessent wrote:
> Corinna Vinschen wrote:
> 
> > Thanks, please apply.
> 
> I checked in the change a day or two ago
> (http://sourceware.org/cgi-bin/cvsweb.cgi/htdocs/setup.html?cvsroot=cygwin)
> but the live copy (http://www.cygwin.com/setup.html) still has not
> updated.  Is the automatic trigger script broken?

I don't know about the script.  I'm updating manually.  I did a few
minutes ago so your change should be visible now.


Corinna

-- 
Corinna Vinschen                  Please, send mails regarding Cygwin to
Cygwin Project Co-Leader          cygwin AT cygwin DOT com
Red Hat

Re: [wwwdocs patch] mention cygport as "method three"

[Christopher Faylor]

On Fri, Apr 11, 2008 at 09:40:45AM +0200, Corinna Vinschen wrote:
>On Apr 10 23:04, Brian Dessent wrote:
>> Corinna Vinschen wrote:
>> 
>> > Thanks, please apply.
>> 
>> I checked in the change a day or two ago
>> (http://sourceware.org/cgi-bin/cvsweb.cgi/htdocs/setup.html?cvsroot=cygwin)
>> but the live copy (http://www.cygwin.com/setup.html) still has not
>> updated.  Is the automatic trigger script broken?
>
>I don't know about the script.  I'm updating manually.  I did a few
>minutes ago so your change should be visible now.

Argh.  It's supposed to be automatic.  Please don't just check something in like
this without giving me a chance to look into the problem.

cgf

Re: [wwwdocs patch] mention cygport as "method three"

[Corinna Vinschen]

On Apr 11 11:07, Christopher Faylor wrote:
> On Fri, Apr 11, 2008 at 09:40:45AM +0200, Corinna Vinschen wrote:
> >On Apr 10 23:04, Brian Dessent wrote:
> >> Corinna Vinschen wrote:
> >> 
> >> > Thanks, please apply.
> >> 
> >> I checked in the change a day or two ago
> >> (http://sourceware.org/cgi-bin/cvsweb.cgi/htdocs/setup.html?cvsroot=cygwin)
> >> but the live copy (http://www.cygwin.com/setup.html) still has not
> >> updated.  Is the automatic trigger script broken?
> >
> >I don't know about the script.  I'm updating manually.  I did a few
> >minutes ago so your change should be visible now.
> 
> Argh.  It's supposed to be automatic.  Please don't just check something in like
> this without giving me a chance to look into the problem.

Ok.  I assumed that the automatism is switched off, sorry.


Corinna

-- 
Corinna Vinschen                  Please, send mails regarding Cygwin to
Cygwin Project Co-Leader          cygwin AT cygwin DOT com
Red Hat

Re: [wwwdocs patch] mention cygport as "method three"

[Christopher Faylor]

On Fri, Apr 11, 2008 at 05:14:09PM +0200, Corinna Vinschen wrote:
>On Apr 11 11:07, Christopher Faylor wrote:
>> On Fri, Apr 11, 2008 at 09:40:45AM +0200, Corinna Vinschen wrote:
>> >On Apr 10 23:04, Brian Dessent wrote:
>> >> Corinna Vinschen wrote:
>> >> 
>> >> > Thanks, please apply.
>> >> 
>> >> I checked in the change a day or two ago
>> >> (http://sourceware.org/cgi-bin/cvsweb.cgi/htdocs/setup.html?cvsroot=cygwin)
>> >> but the live copy (http://www.cygwin.com/setup.html) still has not
>> >> updated.  Is the automatic trigger script broken?
>> >
>> >I don't know about the script.  I'm updating manually.  I did a few
>> >minutes ago so your change should be visible now.
>> 
>> Argh.  It's supposed to be automatic.  Please don't just check something in like
>> this without giving me a chance to look into the problem.
>
>Ok.  I assumed that the automatism is switched off, sorry.

There are two errors in the logs, one for this file and one for
cygwin-pkg-maint.  My theory would have been that the group ownership on
the cygwin directory was somehow set to root except that
cygwin-pkg-maint should not have been a problem for you Corinna.

But, anyway, I've changed the group of the directory to 'cygwin'.

Brian would you mind making another change to setup.html and see if it
is auto-updated?

cgf

Re: [wwwdocs patch] mention cygport as "method three"

[Corinna Vinschen]

On Apr 11 11:45, Christopher Faylor wrote:
> On Fri, Apr 11, 2008 at 05:14:09PM +0200, Corinna Vinschen wrote:
> >On Apr 11 11:07, Christopher Faylor wrote:
> >> On Fri, Apr 11, 2008 at 09:40:45AM +0200, Corinna Vinschen wrote:
> >> >On Apr 10 23:04, Brian Dessent wrote:
> >> >> Corinna Vinschen wrote:
> >> >> 
> >> >> > Thanks, please apply.
> >> >> 
> >> >> I checked in the change a day or two ago
> >> >> (http://sourceware.org/cgi-bin/cvsweb.cgi/htdocs/setup.html?cvsroot=cygwin)
> >> >> but the live copy (http://www.cygwin.com/setup.html) still has not
> >> >> updated.  Is the automatic trigger script broken?
> >> >
> >> >I don't know about the script.  I'm updating manually.  I did a few
> >> >minutes ago so your change should be visible now.
> >> 
> >> Argh.  It's supposed to be automatic.  Please don't just check something in like
> >> this without giving me a chance to look into the problem.
> >
> >Ok.  I assumed that the automatism is switched off, sorry.
> 
> There are two errors in the logs, one for this file and one for
> cygwin-pkg-maint.  My theory would have been that the group ownership on
> the cygwin directory was somehow set to root except that
> cygwin-pkg-maint should not have been a problem for you Corinna.

I could check in stuff into the htdocs CVS all the time.  For some
reason it never showed up in the web directory.

Erm...

No, that's not quite right.  Actually, AFAIR, a couple of months ago the
automatism didn't work for some reaosn and I think since then I just
didn't wait for the change to show up, but always just called `cvs up'
manually.  Next time I will just wait for the change to happen.

How often is the web area updated?
 

Corinna

-- 
Corinna Vinschen                  Please, send mails regarding Cygwin to
Cygwin Project Co-Leader          cygwin AT cygwin DOT com
Red Hat

Re: [wwwdocs patch] mention cygport as "method three"

[Christopher Faylor]

On Fri, Apr 11, 2008 at 05:53:43PM +0200, Corinna Vinschen wrote:
>On Apr 11 11:45, Christopher Faylor wrote:
>> On Fri, Apr 11, 2008 at 05:14:09PM +0200, Corinna Vinschen wrote:
>> >On Apr 11 11:07, Christopher Faylor wrote:
>> >> On Fri, Apr 11, 2008 at 09:40:45AM +0200, Corinna Vinschen wrote:
>> >> >On Apr 10 23:04, Brian Dessent wrote:
>> >> >> Corinna Vinschen wrote:
>> >> >> 
>> >> >> > Thanks, please apply.
>> >> >> 
>> >> >> I checked in the change a day or two ago
>> >> >> (http://sourceware.org/cgi-bin/cvsweb.cgi/htdocs/setup.html?cvsroot=cygwin)
>> >> >> but the live copy (http://www.cygwin.com/setup.html) still has not
>> >> >> updated.  Is the automatic trigger script broken?
>> >> >
>> >> >I don't know about the script.  I'm updating manually.  I did a few
>> >> >minutes ago so your change should be visible now.
>> >> 
>> >> Argh.  It's supposed to be automatic.  Please don't just check something in like
>> >> this without giving me a chance to look into the problem.
>> >
>> >Ok.  I assumed that the automatism is switched off, sorry.
>> 
>> There are two errors in the logs, one for this file and one for
>> cygwin-pkg-maint.  My theory would have been that the group ownership on
>> the cygwin directory was somehow set to root except that
>> cygwin-pkg-maint should not have been a problem for you Corinna.
>
>I could check in stuff into the htdocs CVS all the time.  For some
>reason it never showed up in the web directory.
>
>Erm...
>
>No, that's not quite right.  Actually, AFAIR, a couple of months ago the
>automatism didn't work for some reaosn and I think since then I just
>didn't wait for the change to show up, but always just called `cvs up'
>manually.  Next time I will just wait for the change to happen.
>
>How often is the web area updated?

It is supposed to happen as soon as the file is checked in.

If you have been manually updating files as root that could account for
the problem.

cgf

Re: [wwwdocs patch] mention cygport as "method three"

[Corinna Vinschen]

On Apr 11 12:02, Christopher Faylor wrote:
> On Fri, Apr 11, 2008 at 05:53:43PM +0200, Corinna Vinschen wrote:
> >No, that's not quite right.  Actually, AFAIR, a couple of months ago the
> >automatism didn't work for some reaosn and I think since then I just
> >didn't wait for the change to show up, but always just called `cvs up'
> >manually.  Next time I will just wait for the change to happen.
> >
> >How often is the web area updated?
> 
> It is supposed to happen as soon as the file is checked in.
> 
> If you have been manually updating files as root that could account for
> the problem.

Uh oh...


Corinna

-- 
Corinna Vinschen                  Please, send mails regarding Cygwin to
Cygwin Project Co-Leader          cygwin AT cygwin DOT com
Red Hat

Re: [wwwdocs patch] mention cygport as "method three"

[Brian Dessent]

Christopher Faylor wrote:

> Brian would you mind making another change to setup.html and see if it
> is auto-updated?

It seems to be working fine now.  The file in sourceware/htdocs/cygwin
is automatically updated and is mode 775, group cygwin.

Brian

Re: [wwwdocs patch] mention cygport as "method three"

[Christopher Faylor]

On Fri, Apr 11, 2008 at 06:26:52PM -0700, Brian Dessent wrote:
>Christopher Faylor wrote:
>>Brian would you mind making another change to setup.html and see if it
>>is auto-updated?
>
>It seems to be working fine now.  The file in sourceware/htdocs/cygwin
>is automatically updated and is mode 775, group cygwin.

Thanks for confirming.

cgf