From nobody Mon Oct 31 16:33:30 2022 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4N1JcV6FCwz4gdcp for ; Mon, 31 Oct 2022 16:33:30 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4N1JcV5nlrz3chv; Mon, 31 Oct 2022 16:33:30 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1667234010; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=GZ1+4jVp20joiROqkSv+JMuah9fNQaUJAy5fmVPvPeo=; b=GOIwg4v2lIs5+6cOKBceccdMGVSUh3IWL8/uhJI7L/SsyYpY/8XRlQv0YNNdOJzhGddgMr j9VLHqEdh25QTDnC8QbFzkLM/Yc2qZ8DPJk80eUBa3cpEjD0LfcsUpyU8XyAY8aN+NTmPI 3Y3ZPp5+mLK4DtyQlAY7dngEBrrO7EHx1NwJZRtR5yBXvXduT90uOUfnG1aVlks5TbChos OPNy3EDTwgDLRajUYHVcsYaxbVBF5mqesLxI1vdAhg/cwEYsug8vQoeDMEFm2rk76ZL3AX j6/778WlMNtZtsXuSE1ogAIHnOhmx0NlnaorqM6SSsdDM6Png6aTt8dx1gqckA== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4N1JcV4rdKzk7J; Mon, 31 Oct 2022 16:33:30 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 29VGXUHl046197; Mon, 31 Oct 2022 16:33:30 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 29VGXUCa046196; Mon, 31 Oct 2022 16:33:30 GMT (envelope-from git) Date: Mon, 31 Oct 2022 16:33:30 GMT Message-Id: <202210311633.29VGXUCa046196@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Pau Amma Subject: git: 59733057fc - main - Update FAQ 2.2 with current doc layout and formats. List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: pauamma X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 59733057fc1332d59b669b4e065268f42ede1dfd Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1667234010; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=GZ1+4jVp20joiROqkSv+JMuah9fNQaUJAy5fmVPvPeo=; b=vscak3o8g/Y9PWf9UleqskBStkD2tT3SHxVGalKI2ENS/V8gl3y2cNDhUr/fJ4q3jC6n1Y Wv2TBTQxDW88AuFSF9dhWNyTtOQ644f6kvgXxPIgdJNluAfQYbyijX4BhuaMkSqDXVf3Qx /CKlDbgSYI0Yo8ANrNSB8xHBcCIMa3docTJCZlFWtMJk5yINo73A5dVwqIcMZr9+P7aLwj 4u+otXVknYEmmQdU1skoFcHesZwFqr6DC+lXJD6bcOcrzcCp+TLeuV4+IMAUlGhEuCuDdV aGqjqqmkCwtGc6uMRtg2gSVx/sTxE89NgWbFB/uPjII5doGDHb58tvUk5MAxOQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1667234010; a=rsa-sha256; cv=none; b=BTlFMO3Ro4n/6LnWflEhZRqFYaPH76wO6Ew0rOXOOF2VVUdTQJTSUeAdZeT1VuAGTiSF0X iNIqxXURf0P9ar7kQG0ggwjVk+jZbGhZJl/bAZl9tAj70HLEfhJ3M5JAN1HwjsI5Iql+kp 2GvpVupCKIaTCKGvQgzeLoTdZtf47HTBy7J6bR/3A4pbatHxsyF4D8d95Kd4jTXhnf4wrf OwH+jGBbQzm8Zy6g8lsbViMLqSmOVZdm0zGEpsM259Fz23a06Xjla1JiDqw42x1QTHZHVw qCFa+3vsz60R3EQ9JeQt1pGcFxQCjUw2MvratJe732ByASYHYcQorJ6CyACOVA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by pauamma: URL: https://cgit.FreeBSD.org/doc/commit/?id=59733057fc1332d59b669b4e065268f42ede1dfd commit 59733057fc1332d59b669b4e065268f42ede1dfd Author: Pau Amma AuthorDate: 2022-10-13 02:54:26 +0000 Commit: Pau Amma CommitDate: 2022-10-31 16:30:42 +0000 Update FAQ 2.2 with current doc layout and formats. Graham Perrin's changes and a few I only spotted now. Reviewed by: gjb, grahamperrin Approved by: gjb (mentor) Differential Revision: https://reviews.freebsd.org/D36976 --- documentation/content/en/books/faq/_index.adoc | 113 +++++++++++-------------- 1 file changed, 50 insertions(+), 63 deletions(-) diff --git a/documentation/content/en/books/faq/_index.adoc b/documentation/content/en/books/faq/_index.adoc index 5ea65360d4..45e849d05b 100644 --- a/documentation/content/en/books/faq/_index.adoc +++ b/documentation/content/en/books/faq/_index.adoc @@ -263,16 +263,15 @@ Before submitting a problem report, read extref:{problem-reports}[Writing FreeBS The project produces a wide range of documentation, available online from this link: https://www.FreeBSD.org/docs/[https://www.FreeBSD.org/docs/]. [[doc-formats]] -=== Is the documentation available in other formats, such as plain text (ASCII), or PDF? +=== Is the documentation available in other formats, such as PDF? -Yes. The documentation is available in a number of different formats and compression schemes on the FreeBSD FTP site, -in the https://download.freebsd.org/doc/[/doc/] directory. +Yes. +link:https://download.freebsd.org/doc/[The documentation is also available in several formats] on the FreeBSD download site. -The documentation is categorized in a number of different ways. -These include: +Documentation directories are categorized according to: * The document's name, such as `faq`, or `handbook`. -* The document's language and encoding. These are based on the locale names found under [.filename]#/usr/share/locale# on a FreeBSD system. The current languages and encodings are as follows: +* The document's language, based on the locale names found under [.filename]#/usr/share/locale# on a FreeBSD system, with the encodings removed as all documentation now uses UTF-8. The current languages are: + [.informaltable] [cols="1,1", frame="none", options="header"] @@ -280,62 +279,62 @@ These include: | Name | Meaning -|`en_US.ISO8859-1` -|English (United States) +|`en` +|English -|`bn_BD.ISO10646-1` +|`bn-bd` |Bengali or Bangla (Bangladesh) -|`da_DK.ISO8859-1` -|Danish (Denmark) +|`da` +|Danish -|`de_DE.ISO8859-1` -|German (Germany) +|`de` +|German -|`el_GR.ISO8859-7` -|Greek (Greece) +|`el` +|Greek -|`es_ES.ISO8859-1` -|Spanish (Spain) +|`es` +|Spanish -|`fr_FR.ISO8859-1` -|French (France) +|`fr` +|French -|`hu_HU.ISO8859-2` -|Hungarian (Hungary) +|`hu` +|Hungarian -|`it_IT.ISO8859-15` -|Italian (Italy) +|`it` +|Italian -|`ja_JP.eucJP` -|Japanese (Japan, EUC encoding) +|`ja` +|Japanese -|`ko_KR.UTF-8` -|Korean (Korea, UTF-8 encoding) +|`ko` +|Korean -|`mn_MN.UTF-8` -|Mongolian (Mongolia, UTF-8 encoding) +|`mn` +|Mongolian -|`nl_NL.ISO8859-1` -|Dutch (Netherlands) +|`nl` +|Dutch -|`pl_PL.ISO8859-2` -|Polish (Poland) +|`pl` +|Polish -|`pt_BR.ISO8859-1` +|`pt-br` |Portuguese (Brazil) -|`ru_RU.KOI8-R` -|Russian (Russia, KOI8-R encoding) +|`ru` +|Russian -|`tr_TR.ISO8859-9` -|Turkish (Turkey) +|`tr` +|Turkish -|`zh_CN.UTF-8` -|Simplified Chinese (China, UTF-8 encoding) +|`zh-cn` +|Simplified Chinese (China) -|`zh_TW.UTF-8` -|Traditional Chinese (Taiwan, UTF-8 encoding) +|`zh-tw` +|Traditional Chinese (Taiwan) |=== + [NOTE] @@ -351,41 +350,29 @@ Some documents may not be available in all languages. | Format | Meaning -|`html-split` -|A collection of small, linked, HTML files. - |`html` -|One large HTML file containing the entire document +|Depending on the document: one large HTML file containing the entire document or a collection of small linked HTML files, both together with images, stylesheets, and JavaScript |`pdf` |Adobe's Portable Document Format - -|`txt` -|Plain text |=== * The compression and packaging scheme. -.. Where the format is `html-split`, the files are bundled up using man:tar[1]. The resulting [.filename]#.tar# is then compressed using the compression schemes detailed in the next point. -.. All the other formats generate one file. For example, [.filename]#article.pdf#, [.filename]#book.html#, and so on. -+ -These files are then compressed using either the `zip` or `bz2` compression schemes. -man:tar[1] can be used to uncompress these files. -+ -So the PDF version of the Handbook, compressed using `bzip2` will be stored in a file called [.filename]#book.pdf.bz2# in the [.filename]#handbook/# directory. +.. Where the format is `html`, the files are bundled up using man:tar[1]. The resulting [.filename]#.tar# is then compressed using man:gzip[1]. +.. The PDF format generates one file. For example, [.filename]#explaining-bsd_en.pdf#, [.filename]#faq_en.pdf#, and so on. -After choosing the format and compression mechanism, download the compressed files, uncompress them, and then copy the appropriate documents into place. +After choosing the format, download the files, uncompress them if necessary, then copy the appropriate documents into place. -For example, the split HTML version of the FAQ, compressed using man:bzip2[1], -can be found in [.filename]#doc/en_US.ISO8859-1/books/faq/book.html-split.tar.bz2# To download and uncompress that file, type: +For example, the HTML version of the FAQ can be found in [.filename]#doc/en/books/faq/faq_en.tar.gz# To download and uncompress that file, type: [source,shell] .... -# fetch https://download.freebsd.org/doc/en_US.ISO8859-1/books/faq/book.html-split.tar.bz2 -# tar xvf book.html-split.tar.bz2 +% fetch https://download.freebsd.org/doc/en/books/faq/faq_en.tar.gz +% tar xvf faq_en.tar.gz .... If the file is compressed, tar will automatically detect the appropriate format and decompress it correctly, -resulting in a collection of [.filename]#.html# files. -The main one is called [.filename]#index.html#, which will contain the table of contents, introductory material, and links to the other parts of the document. +resulting in a collection of files. +The main one is called [.filename]#index.html#, which will contain the whole document, starting with the table of contents linking to the other parts of the document. [[mailing]] === Where do I find info on the FreeBSD mailing lists? What FreeBSD news groups are available?