About the opam package

About the opam package

[Sora Morimoto]

Hi everyone. I am a developer involved in the development of the OCaml ecosystem.

First of all, I am not yet used to using a mailing list as a method of communication. I believe I have done enough research before coming here, but I apologize in advance if I make any mistakes.

Now, I wanted to help with the maintenance of the opam package for Cygwin, but after reading the documentation I still do not know what to do. Specifically, I do not even know where the build script source is, and where to send the patch.

Can someone please teach me?

Re: About the opam package

[Brian Inglis]

On 2020-07-14 17:17, Sora Morimoto wrote:
> Hi everyone. I am a developer involved in the development of the OCaml ecosystem.
> First of all, I am not yet used to using a mailing list as a method of
> communication. I believe I have done enough research before coming here, but I
> apologize in advance if I make any mistakes.
> Now, I wanted to help with the maintenance of the opam package for Cygwin,
> but after reading the documentation I still do not know what to do.
> Specifically, I do not even know where the build script source is, and where
> to send the patch.
> Can someone please teach me?

Using the Cygwin Setup program, install:

* cygport package

  - standard method for building and maintaining packages for the Cygwin
    distribution
  - similar to Gentoo Portage but not compatible with it
  - Setup will auto-install all required build tools which are its dependencies

* any ocaml-... packages you need

* Opam

* possibly Opam-installer

and check the Install sources checkbox on that/those latter.
The sources are normally installed under /usr/src/ IIRC.

To rebuild a package build using cygport, cd into the /usr/src/$PKG (replace by
actual package name - use tab completion if your shell supports that) directory,
check the $PKG.cygport file to see if there are any extra build dependencies you
need to install before proceeding (REQUIRES are *runtime* dependencies
auto-installed by Setup when a package is installed).

To rebuild a cygport package (to check your setup includes all the tools and
libraries needed before making any changes) just run:

	$ cygport $PKG.cygport download all test

which will download the upstream sources, build and create an installable Cygwin
package, and run any tests included in the package.

For more information about cygport run:

	$ cygstart /usr/share/doc/cygport/html/manual/index.html

to open the manual in your default browser, or check out ocaml related entries:

	$ cygstart /usr/share/doc/cygport/html/manual/masterindex.html#O

-- 
Take care. Thanks, Brian Inglis, Calgary, Alberta, Canada

This email may be disturbing to some readers as it contains
too much technical detail. Reader discretion is advised.
[Data in IEC units and prefixes, physical quantities in SI.]

Re: About the opam package

[Andy Li]

Hi,

On Wed, Jul 15, 2020 at 7:17 AM Sora Morimoto <sora@morimoto.io> wrote:
> Now, I wanted to help with the maintenance of the opam package for Cygwin, but after reading the documentation I still do not know what to do. Specifically, I do not even know where the build script source is, and where to send the patch.

I'm the maintainer of the opam cygwin package. (FYI, you can see the
list of cygwin package maintainer at
https://cygwin.com/cygwin-pkg-maint)
The package source is at https://github.com/andyli/opam-cygwin
Feel free to send me PR.

Best,
Andy

RE: About the opam package

[Sora Morimoto]

Hi, Andy!

I know you well and was surprised to know that you are the maintainer of this package.
I just sent a PR to your repository.

Thank you,
Sora

From: Andy Li
Sent: Wednesday, July 15, 2020 11:25 AM
To: Sora Morimoto
Cc: cygwin-apps@cygwin.com
Subject: Re: About the opam package

Hi,

On Wed, Jul 15, 2020 at 7:17 AM Sora Morimoto <sora@morimoto.io> wrote:
> Now, I wanted to help with the maintenance of the opam package for Cygwin, but after reading the documentation I still do not know what to do. Specifically, I do not even know where the build script source is, and where to send the patch.

I'm the maintainer of the opam cygwin package. (FYI, you can see the
list of cygwin package maintainer at
https://cygwin.com/cygwin-pkg-maint)
The package source is at https://github.com/andyli/opam-cygwin
Feel free to send me PR.

Best,
Andy

RE: About the opam package

[Sora Morimoto]

Hi, Brian!

Thank you for your detailed explanation! I only sent a pull request to Andy's repository this time, but if I need to do the other work, I will definitely refer to my notes based on what you taught me!

Thanks,
Sora

From: Brian Inglis
Sent: Wednesday, July 15, 2020 10:43 AM
To: cygwin-apps@cygwin.com
Cc: Sora Morimoto
Subject: Re: About the opam package

On 2020-07-14 17:17, Sora Morimoto wrote:
> Hi everyone. I am a developer involved in the development of the OCaml ecosystem.
> First of all, I am not yet used to using a mailing list as a method of
> communication. I believe I have done enough research before coming here, but I
> apologize in advance if I make any mistakes.
> Now, I wanted to help with the maintenance of the opam package for Cygwin,
> but after reading the documentation I still do not know what to do.
> Specifically, I do not even know where the build script source is, and where
> to send the patch.
> Can someone please teach me?

Using the Cygwin Setup program, install:

* cygport package

  - standard method for building and maintaining packages for the Cygwin
    distribution
  - similar to Gentoo Portage but not compatible with it
  - Setup will auto-install all required build tools which are its dependencies

* any ocaml-... packages you need

* Opam

* possibly Opam-installer

and check the Install sources checkbox on that/those latter.
The sources are normally installed under /usr/src/ IIRC.

To rebuild a package build using cygport, cd into the /usr/src/$PKG (replace by
actual package name - use tab completion if your shell supports that) directory,
check the $PKG.cygport file to see if there are any extra build dependencies you
need to install before proceeding (REQUIRES are *runtime* dependencies
auto-installed by Setup when a package is installed).

To rebuild a cygport package (to check your setup includes all the tools and
libraries needed before making any changes) just run:

	$ cygport $PKG.cygport download all test

which will download the upstream sources, build and create an installable Cygwin
package, and run any tests included in the package.

For more information about cygport run:

	$ cygstart /usr/share/doc/cygport/html/manual/index.html

to open the manual in your default browser, or check out ocaml related entries:

	$ cygstart /usr/share/doc/cygport/html/manual/masterindex.html#O

-- 
Take care. Thanks, Brian Inglis, Calgary, Alberta, Canada

This email may be disturbing to some readers as it contains
too much technical detail. Reader discretion is advised.
[Data in IEC units and prefixes, physical quantities in SI.]

Re: About the opam package

[Jon Turney]

On 15/07/2020 03:25, Andy Li wrote:
> Hi,
> 
> On Wed, Jul 15, 2020 at 7:17 AM Sora Morimoto wrote:
>> Now, I wanted to help with the maintenance of the opam package for
>> Cygwin, but after reading the documentation I still do not know
>> what to do. Specifically, I do not even know where the build script
>> source is, and where to send the patch.
> 
> I'm the maintainer of the opam cygwin package. (FYI, you can see the
> list of cygwin package maintainer at
> https://cygwin.com/cygwin-pkg-maint)
> The package source is at https://github.com/andyli/opam-cygwin
> Feel free to send me PR.
> 

Andy,

Please consider mirroring that repo to cygwin.com/git/cygwin-packages/ 
(as detailed at [1])

[1] https://cygwin.com/packaging/repos.html

Re: About the opam package

[Andy Li]

On Fri, Jul 17, 2020 at 9:08 PM Jon Turney <jon.turney@dronecode.org.uk> wrote:
> Please consider mirroring that repo to cygwin.com/git/cygwin-packages/
> (as detailed at [1])
>
> [1] https://cygwin.com/packaging/repos.html

I wasn't aware of that. Thanks for pointing it out.
I have just set up auto mirroring for all my cygwin packages.

Best,
Andy

Re: About the opam package

[Brian Inglis]

On 2020-07-17 07:08, Jon Turney wrote:
> On 15/07/2020 03:25, Andy Li wrote:
>> On Wed, Jul 15, 2020 at 7:17 AM Sora Morimoto wrote:
>>> Now, I wanted to help with the maintenance of the opam package for
>>> Cygwin, but after reading the documentation I still do not know
>>> what to do. Specifically, I do not even know where the build script
>>> source is, and where to send the patch.
>>
>> I'm the maintainer of the opam cygwin package. (FYI, you can see the
>> list of cygwin package maintainer at
>> https://cygwin.com/cygwin-pkg-maint)
>> The package source is at https://github.com/andyli/opam-cygwin
>> Feel free to send me PR.

> Please consider mirroring that repo to cygwin.com/git/cygwin-packages/ (as
> detailed at [1])
> 
> [1] https://cygwin.com/packaging/repos.html

Might want to remind ITA adopters (300 to go) they need to git clone before
cygport-ing and commit before git push-ing - I had a duh! moment before I
realized what's up. ;^>

-- 
Take care. Thanks, Brian Inglis, Calgary, Alberta, Canada

This email may be disturbing to some readers as it contains
too much technical detail. Reader discretion is advised.
[Data in IEC units and prefixes, physical quantities in SI.]