Fixes, e.g., manual articles/books build (i.e., typing `make` in the right
directory).
There were two problems:
1. Git or SVN information retrieval depends on the current locale, and doesn't
work with non-English ones.
2. Fallback for LATESTREVISION most of the time (sometimes works, probable
race) itself fails because PWD is set to document's directory + '/obj', but
sources are in the document's directory.
Problem 2 is the most annoying because documentation builds simply fails
(`xsltproc` becomes unable to resolve 'latestrevision.*' variables in, e.g.,
articles). But point 2's failure appears only because of point 1's failure,
which doesn't happen on a machine with English or C locale.
PR: 246936
the generated file causing broken files. This does not redirect drivers
output which still write to stdout.
I'm currently seeing "**** Warning: glyf overlaps cmap, truncating."
during esptopng conversion leading to broken .pnm.
This change prevents the broken .pnm file.
Remove references to CVS/SVN and replace with Git equivalents.
Note the files are not automatically updated on the builder after
a change is committed.
Remove RCSIDs.
Sponsored by: Rubicon Communications, LLC (netgate.com)
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
Summary:
The doc repository is not mirrored to Subversion so updating the
repository from Subversion does not make sense. Remove
Subversion-specific files too.
While here remove now defunct $FreeBSD$ markers in affected files.
Test Plan:
make clean
make update
make
Reviewed by: bcr, ygy, doceng (gjb)
Differential Revision: https://reviews.freebsd.org/D27678
Subscribers: drewery, emaste
- Add a <githash> tag which accepts a Git hash. Leave
<revnumber> as is for svn revisions. In theory we
could add a new attribute to <revnumber> to say which
VCS to use, but this would require tagging either all
SVN revisions or all Git hashes explicitly which would
be invasive. A new tag going forward seems simpler.
- Revert svnweb.link back to generating svnweb links. This
fixes all the explicit <revnumber>'s referring to SVN src
commits in existing documentation.
- Add a cgit.link which links to a Git commit in cgit.
githash generates cgit.link's when asked to generate a
href.
Reviewed by: gjb, ygy
Differential Revision: https://reviews.freebsd.org/D27703
Steps 1-4 from the Committer's guide:
- Add entries for Juraj Lutter <otis>
- Add GPG key
And while here, also:
- Fix misindentation
- Remove a stray empty line
Reviewed by: osa (mentor)
Approved by: osa (mentor)
Differential Revision: https://reviews.freebsd.org/D27617
The $FreeBSD$ tag is obsolete. Remove it. Note: this is a test commit
to ensure that my instructions work end to end. If we do the rest,
then we should do it in bulk so individuals should hold off doing
similar commits unless changing their key.
building from the git sources is indeed fine.
Note: these scripts are not automatically updated on the builder,
so I will manually update them and monitor for failures.
Sponsored by: Rubicon Communications, LLC (netgate.com)