Commit graph

6157 commits

Author SHA1 Message Date
Li-Wen Hsu
076e392029
Add freebsd-office-hours-2021-01-27
Reviewed by:	debdrup, ygy
Approved by:	ygy
Differential Revision:	https://reviews.freebsd.org/D28252
2021-01-21 00:39:59 +08:00
Olivier Certner
1e7c4a3928 doc.docbook.mk: Fix LATESTREVISION determination, causes build failure on non-English locales
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
2021-01-19 15:18:40 +01:00
Guangyuan Yang
83f28517ec events2020: clean up cancelled events
While I was there, also cleaned up locations for online events.

Reviewed by:	debdrup
Differential Revision:	https://reviews.freebsd.org/D27989
2021-01-17 19:05:35 +00:00
Lutz Donnerhacke
751e8bc383 Add committer entries in doc for Lutz Donnerhacke <donner>
Summary:
Steps 1-4 from the Committer's guide:
  - Add entries for Lutz Donnerhacke <donner>
  - Add GPG key

Reviewers: kp, philip

Reviewed By: kp, philip

Differential Revision: https://reviews.freebsd.org/D27967
2021-01-17 11:53:26 +01:00
Daniel Ebdrup Jensen
31f481ca1c Add 2020Q4 status report to the newsflash
Reviewed by:	PauAmma
Differential Revision:	https://reviews.freebsd.org/D28177
2021-01-16 15:41:13 +01:00
Danilo G. Baio
c46200e885 Fix build
Approved by:   ygy (doc)
2021-01-14 14:28:47 -03:00
Daniel Ebdrup Jensen
47b7f1f716 usergroups: Remove Iran User Group
PR:		252662
2021-01-14 14:05:49 +01:00
Marc Fonvieille
0d6f42cb77 Redirect gs stdout to stderr. This will prevent warnings to be part of
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.
2021-01-10 17:01:58 +01:00
Li-Wen Hsu
f3bf61d561
Add link to git pepository
Approved by:	ygy
Differential Revision:	https://reviews.freebsd.org/D28015
2021-01-07 17:13:44 +08:00
Neel Chauhan
0c529cc483 Set year for my commit bit as 2021 2021-01-05 07:26:44 -08:00
Neel Chauhan
7c1b14fad8 Add committer entries for Neel Chauhan <nc>
Steps 1-4 from the Committer's guide:
  - Add entries for Neel Chauhan <nc>
  - Add GPG key

Reviewed by:            0mp
Approved by:            0mp (mentor)
Differential Revision:  https://reviews.freebsd.org/D27957
2021-01-04 14:00:30 -08:00
Glen Barber
77c28ff525 docbuild: source 'local.conf' if it exists
Sponsored by:	Rubicon Communications, LLC (netgate.com)
2021-01-04 13:50:48 -05:00
Glen Barber
3e766ab07c Add GITARGS to dobuild.sh
When local.conf exists, GITARGS can be used to append checkout-specific
arguments to git.

Sponsored by:	Rubicon Communications, LLC (netgate.com)
2021-01-04 13:38:21 -05:00
Mateusz Piotrowski
2a60f7e751 Remove mentions of RCS Id from pgpkeys README
We don't put RCS Ids into key files anymore.
2021-01-04 18:38:50 +01:00
Mateusz Piotrowski
6bc1fe6731 Update my PGP key 2021-01-04 18:29:56 +01:00
Glen Barber
3c096a4fff copyrights: Happy New Year 2021
Good riddance 2020.

Sponsored by:	Rubicon Communications, LLC (netgate.com)
2020-12-31 10:27:11 -05:00
Glen Barber
d89f64cb54 docbuild: source 'local.conf' for machine-specific variables if exists
Sponsored by:	Rubicon Communications, LLC (netgate.com)
2020-12-30 23:24:38 -05:00
Glen Barber
e9a6e6f104 docbuild: update PDF file build scripts to use Git
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)
2020-12-30 11:52:21 -05:00
Glen Barber
cb1d034ab1 docbuild: add scripts used to build the PDF versions of the Handbook
Sponsored by:	Rubicon Communications, LLC (netgate.com)
2020-12-30 11:40:07 -05:00
Peter Jeremy
0a83c0b2a9 Update my PGP key.
(Rather belatedly) extend the expiration date by 2 years.
2020-12-27 15:15:30 +11:00
Niclas Zeising
83de4c62b7 share/pgpkeys: Update my key
Update my pgp key with new signature, as the previous version was set to
expire at the end of the year.
2020-12-26 12:08:18 +01:00
Benedict Reuschling
c9f7d0b3d8 Replace jpgs with pngs, the latter of which are supported and displayed.
Reported by:	    meena (on EFnet IRC #bsddocs channel)
2020-12-25 20:39:38 +00:00
Benedict Reuschling
1980db649f Add new WINE handbook chapter written as part of Google Season of Docs 2020.
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
2020-12-25 16:48:11 +00:00
Rene Ladan
eaf07aef56 Update the build infrastructure to use Git instead of Subversion
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
2020-12-23 20:06:07 +01:00
John Baldwin
e98cc89741 Generate links to cgit instead of svn in document title blocks.
PR:		251940
Reviewed by:	emaste, gjb, ygy
Differential Revision:	https://reviews.freebsd.org/D27704
2020-12-22 13:56:47 -08:00
John Baldwin
86bba6a538 Add infrastructure for links to Git commits.
- 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
2020-12-22 13:48:38 -08:00
Rene Ladan
28dade007b share/pgpkeys/README: Update to the Git era
- convert loose Subversion instructions to loose Git instructions
- remove now defunct $FreeBSD$ marker
2020-12-19 14:05:57 +01:00
Guangyuan Yang
e6320b07f5 Fix revision link after Git transition
PR:		251940
Reported by:	emaste
2020-12-18 18:14:18 +00:00
Warner Losh
a9729ccf88 Add news entry for the conversion of the src repository to Git. The
cutover from Subversion to Git is this weekend.
2020-12-16 22:16:49 -07:00
Glen Barber
aec6122b7b news.xml: fix spacing/whitespace/indentation issues.
Sponsored by:	Rubicon Communications, LLC (netgate.com)
2020-12-16 18:53:15 -05:00
Glen Barber
14a2d969e1 news.xml: remove a stray date reference.
Sponsored by:	Rubicon Communications, LLC (netgate.com)
2020-12-16 18:51:21 -05:00
Warner Losh
1ce17f83bd Add news that FreeBSD-doc switched over to git. 2020-12-16 14:03:03 -07:00
Glen Barber
3a01c01d82 news.xml: Fix indentation/line wrapping. No functional changes.
Sponsored by:	Rubicon Communications, LLC (netgate.com)
2020-12-16 14:51:51 -05:00
Li-Wen Hsu
63c3f6c81e
Fix the time of 2020-12-16 Office Hours event
Approved by:	ygy (implicitly)
2020-12-17 02:17:25 +08:00
Juraj Lutter
a72c1d6c21 doc: Add committer entries for Juraj Lutter <otis>
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
2020-12-15 20:25:31 +00:00
Li-Wen Hsu
37279d2ef4
Add 2020-12-16 Office Hours event
Approved by: ygy
Differential Revision: https://reviews.freebsd.org/D27616
2020-12-15 20:02:10 +08:00
Gordon Tetlow
925bca73c9 Add updated text and patch for FreeBSD-SA-20:33.openssl
Approved by:	so
2020-12-14 13:28:07 -08:00
Glen Barber
d79b57d3cf Website build: remove 'svn co' references for doc tree operations.
Sponsored by:	Rubicon Communications, LLC (netgate.com)
2020-12-13 16:31:39 -05:00
Glen Barber
b385a81223 Website build: comment the 'git clean', which is causing missing pages.
Sponsored by:	Rubicon Communications, LLC (netgate.com)
2020-12-13 15:13:25 -05:00
Glen Barber
41c404416f Fix argument order from previous commit.
Sponsored by:	Rubicon Communications, LLC (netgate.com)
2020-12-13 15:08:33 -05:00
Glen Barber
6d605a5aa5 Website/docs build: ensure rebase is specified when pulling new updates
Sponsored by:	Rubicon Communications, LLC (netgate.com)
2020-12-13 15:05:19 -05:00
Sergey A. Osokin
7a539fc83b Add my GPG key. 2020-12-12 23:21:10 -05:00
Glen Barber
75c3fd757d addkey.sh: remove adding $FreeBSD$ RCSID, update adding key to repository.
While here, remove $FreeBSD$ RCSID from the script itself.

Sponsored by:	Rubicon Communications, LLC (netgate.com)
2020-12-10 15:07:06 -05:00
Warner Losh
7bbd7b58f8 Remove $FreeBSD$ from my PGP key
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.
2020-12-10 11:43:06 -07:00
Glen Barber
e406313179 Website build: reset fail-mail back to freebsd-doc.
Sponsored by:	Rubicon Communications, LLC (netgate.com)
2020-12-09 16:24:27 -05:00
Glen Barber
70637319d2 website build: update scripts to use the correct Git host.
Sponsored by:	Rubicon Communications, LLC (netgate.com)
2020-12-09 15:51:42 -05:00
Gordon Tetlow
3bde30dfea Add SA-20:33.
Approved by:	so
2020-12-09 11:25:22 -08:00
Glen Barber
31a16cde4a Remove 'head' from 'subtrees', and uncomment the 'main' addition.
Sponsored by:	Rubicon Communications, LLC (netgate.com)
2020-12-05 02:02:09 +00:00
Glen Barber
74ea351cb4 Send fail-mail to me directly until I'm sure the transition to
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)
2020-12-05 00:39:01 +00:00
Glen Barber
9cc5ea8ef8 Update the webupdate script to uncomment git calls prior to the
switchover for the repository.

Sponsored by:	Rubicon Communications, LLC (netgate.com)
2020-12-04 23:13:25 +00:00