Bug 273541

Summary:	FreeBSD Handbook: ZFS for swap: a more detailed warning
Product:	Documentation	Reporter:	Graham Perrin <grahamperrin>
Component:	Books & Articles	Assignee:	Sergio Carlavilla Delgado <carlavilla>
Status:	Closed Not Accepted
Severity:	Affects Some People	CC:	carlavilla, doc
Priority:	---	Keywords:	easy, needs-patch
Version:	Latest
Hardware:	Any
OS:	Any
URL:	https://github.com/freebsd/freebsd-doc/blob/main/documentation/content/en/books/handbook/config/_index.adoc#72-creating-a-swap-file
See Also:	https://reviews.freebsd.org/D41052 https://github.com/openzfs/zfs/pull/14756

Description Graham Perrin 2023-09-03 12:18:00 UTC

D41052 led to <https://cgit.freebsd.org/doc/tree/documentation/content/en/books/handbook/config/_index.adoc?id=9401f487d47fb9147a5c6792e0318b9389749de3#n1469> and this warning under <https://docs.freebsd.org/en/books/handbook/book/#create-swapfile>: 

> Swap files on ZFS file systems are strongly discouraged, as swapping 
> can lead to system hangs.

The warning can be improved, in line with the OpenZFS PR that was reviewed by Brian Behlendorf.

Comment 1 Sergio Carlavilla Delgado freebsd_committer

2023-09-07 19:48:25 UTC

The warning is clear, I close the PR as not accepted.