Document USES=guile.

[andrew_tao173.riddles.org.uk]

Summary

Document USES=guile in the porter's handbook.

See D40194 for the code changes that this applies to.

[carlavilla]

Looks really great!

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

documentation/content/en/books/porters-handbook/special/_index.adoc

4444

Can you please remove this extra line?

4477

Can you please remove this extra line?

[andrew_tao173.riddles.org.uk]

Requested whitespace fixes.

[pauamma_gundo.com]

documentation/content/en/books/porters-handbook/special/_index.adoc

4463

I'd use a reserved example domain here instead. Maybe [e-mail].

4465

As above, for the URL domain.

[andrew_tao173.riddles.org.uk]

documentation/content/en/books/porters-handbook/special/_index.adoc

4463

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

[andrew_tao173.riddles.org.uk]

Fix example domains.

[carlavilla]

Np, we can change the URLs in another review.

[fernape]

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

I made some comments .

Thanks!

documentation/content/en/books/porters-handbook/special/_index.adoc

4252

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.

4300

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.

4319

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

4337

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...

4402

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.

4438

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.

[andrew_tao173.riddles.org.uk]

documentation/content/en/books/porters-handbook/special/_index.adoc

4319

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

[andrew_tao173.riddles.org.uk]

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

Apply a more consistent style to table entries.

[fernape]

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

Thanks for the work!

[carlavilla]

I'm gonna make the commit