Page MenuHomeFreeBSD

Document USES=guile.

Authored by on Aug 1 2023, 7:29 PM.
Referenced Files
Unknown Object (File)
Thu, Nov 23, 3:53 AM
Unknown Object (File)
Tue, Nov 21, 5:12 PM
Unknown Object (File)
Sun, Nov 12, 2:20 AM
Unknown Object (File)
Nov 10 2023, 3:03 AM
Unknown Object (File)
Nov 5 2023, 10:47 AM
Unknown Object (File)
Oct 27 2023, 10:51 PM
Unknown Object (File)
Oct 23 2023, 11:57 AM
Unknown Object (File)
Oct 20 2023, 4:05 PM



Document USES=guile in the porter's handbook.

See D40194 for the code changes that this applies to.

Diff Detail

R9 FreeBSD doc repository
Lint Not Applicable
Tests Not Applicable

Event Timeline

Looks really great!

From the doc side is ok, I'm gonna add ports team too


Can you please remove this extra line?


Can you please remove this extra line? added inline comments.

I'd use a reserved example domain here instead. Maybe


As above, for the URL domain.


That was copied from the Lua example, which in turn I think I copied from the Python example; those should probably be fixed too.

This revision is now accepted and ready to land.Aug 1 2023, 8:14 PM

Np, we can change the URLs in another review.

Great work! It sounds good from the ports point of view.

I made some comments .



Very long sentence. Can we split it?

In most cases, applications should detect the correct version from the configuration variables provided and use pkg-config to determine the name and associated paths.
However, some applications (especially those using their own configuration rules for cmake or meson) will try and always use the latest available version.
In this case either patch the port or declare a build conflict (see below) to ensure that the correct dependency is generated when building outside of poudriere.


Simplify this sentence?

It should not normally be necessary for the port to add any additional dependencies. --> Normally the port should not need any additional dependencies.


If the port cannot be convinced to select a specified Guile version... --> If the port cannot work with a specific Guile version...


porters should be careful, not ports :-) How about:

Such ports must be careful to install Scheme files to... --> Such ports must install Scheme files to...


Probably drop the 'for'?

As for GUILE_CMD and GUILE_CMDPATH, for other tool binaries. --> As GUILE_CMD and GUILE_CMDPATH, for other tool binaries.

or even

Like GUILE_CMD and GUILE_CMDPATH, but for other tool binaries.


I would rephrase this, but I might be wrong:

Where ports using flavors should place a documentation subdirectory --> Documenation subdirectory location for ports using flavors

Same below and in a table above.


That changes the meaning; I'll try and find another way to reword it.

Reword some long or confusing sentences largely following fernape's suggestions.

Apply a more consistent style to table entries.

This revision now requires review to proceed.Aug 2 2023, 5:51 PM

For some reason I'm not in the ports committers group, but you can consider this approved.

Thanks for the work!

This revision is now accepted and ready to land.Aug 3 2023, 6:44 AM

I'm gonna make the commit