Thanks to Aaron Peters for researching and writing this chapter from
scratch. He also provided most of the images, together with Alexander
Leidinger (netchild@). Alexander was also kind enough to be the official
mentor for the WINE side of the content, while I focused on the
documentation side. His insights into WINE from a users perspective
helped make this chapter better by adding information about Homura.
A big thank you to Google Season of Docs 2020 for enabling us to have
Aaron as technical writer working on this project.
I've re-ordered the finalized submission so that the FAQ is the last
part of this chapter. I also moved the "WINE Overview & concepts"
section after the Synopsis for a more logical flow of information.
Additionally, a lot of DocBook editing was done to bring it to the
current form. The remaining checks by textproc/igor revolve around
indentation errors. But one can't fix all of them without violating
others.
Please enjoy running WINE and games on FreeBSD with the help of this
chapter.
Todo:
- Some references to other parts of the chapter or to others in the
handbook need to be replaced by actual links.
- Some of the images could be resized a bit more. I only did it on
those that would create a horizontal scroll bar. Reizing them to 50%
made them small enough to fit the other images while retaining
legible text.
A note on the images: I realize they are mixed JPEG and PNGs in the
same chapter. However, many of the images in the handbook do not
have a uniform image type either (compare IMAGES_EN+= entries in
Makefile). This may be a future project to unify these without
compromising image quality.
Contributed by: Aaron Peters (acpkendo gmail.com)
Reviewed by: netchild, bcr
Sponsored by: Google Season of Docs 2020
Differential Revision: https://reviews.freebsd.org/D27484
Differential Revision: https://reviews.freebsd.org/D27455
Differential Revision: https://reviews.freebsd.org/D27444
Differential Revision: https://reviews.freebsd.org/D27232
Differential Revision: https://reviews.freebsd.org/D27146
Differential Revision: https://reviews.freebsd.org/D26983
Differential Revision: https://reviews.freebsd.org/D26914
Differential Revision: https://reviews.freebsd.org/D26788
This chapter referred to images from the retired Install chapter, which
were missing from the Makefile. Some of the information was out of
date. The original disk organization diagram had been created in an
application that has not existed for over a decade, so I wrote a new
diagram in PostScript. This addresses the PR below. This needs to be
extended to add a GPT version.
PR: 203821
Submitted by: ryan@englandacademy.org
'root-on-zfs' feature. Also add documentation for the 'shell' mode
feature that was not documented before.
PR: docs/187683
Submitted by: Allan Jude <freebsd@allanjude.com>
Approved by: bcr (mentor)
Optimise the images in the bsdinstall chapter using graphics/pngrewrite -
they only require 4 bits per pixel, but several of them were stored as
8bpp PNGs. This approximately halves the total file size, allowing the
handbook pages to load much faster.
reasonable to maintain the reference, use the archived docs.
5-roadmap
checkpoint
dialup-firewall
diskless-x
euro
formatting-media
hats (content moved to htdocs/internal)
multi-os
storage-devices
vinum
zip-drive
All of these articles can be found here:
http://docs.freebsd.org/doc/9.0-RELEASE/usr/share/doc/freebsd/en_US.ISO8859-1/articles/
No objection from: doc@, www@
- Add the 'Enabling Crash Dumps' screen [1]
- Add the 'Manual Configuration' screen
- Replace the 'Final Configuration' screen; the 'Shell' option was removed
and replaced with the 'Manual Configuration' prompt
Reminded by: ryusuke [1]
- Document that bsdinstall will prompt a user if they would like
to set a non-default keymap
- Add the image the displays the prompt for a user to select
an non-default keymap
- Update the final configuration image, where 'Exit' is now the
first option
Submitted/noticed by: dru
Thanks to everyone who worked on this. Special thanks to gavin@ and
wblock@ who worked especially hard to get this in shape and ready for
9.0-RELEASE.
Commit to link this to the build to follow soon.
Split the generation of images up to use a larger font on 1-9, and
smaller on 10-30 to further improve the appearance.
s/seq/jot/ so users on < 9.x can run this script
Submitted by: gjb [1]
