From nobody Fri Feb 17 09:06:28 2023 X-Original-To: stable@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 4PJ5XT33f3z3s2k1 for ; Fri, 17 Feb 2023 09:06:33 +0000 (UTC) (envelope-from mirror176@hotmail.com) Received: from NAM12-MW2-obe.outbound.protection.outlook.com (mail-mw2nam12olkn2040.outbound.protection.outlook.com [40.92.23.40]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mail.protection.outlook.com", Issuer "DigiCert Cloud Services CA-1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4PJ5XS3HP9z3v8g for ; Fri, 17 Feb 2023 09:06:32 +0000 (UTC) (envelope-from mirror176@hotmail.com) Authentication-Results: mx1.freebsd.org; dkim=pass header.d=hotmail.com header.s=selector1 header.b=SUBmjxSf; spf=pass (mx1.freebsd.org: domain of mirror176@hotmail.com designates 40.92.23.40 as permitted sender) smtp.mailfrom=mirror176@hotmail.com; dmarc=pass (policy=none) header.from=hotmail.com; arc=pass ("microsoft.com:s=arcselector9901:i=1") ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=QJbPdj1FE99dEGedniO4sHcslCIhdPj5j3xP7PgKGU/U2NQ+yBfAYu8bQM3zS0B5T7LRUKfHszt0f+tjkl8aZPtytUngDis7Tk5jpNuaK7ze1+5Q6zDzRiZtqhhJQFERLyyotq2wCud8FnjyFzk50xnhM1O1WBclhP9X7AMPPeLlnzh0bTJf6woRp25iVInnHaiu+Zzsjlrff+6B2uFJEcG/M8ylNMXqmXDVUjy+FOhUyV5B+CiEgiaL7hmblOSqTpjtXXPFpUAJ2W4gN2v19GSzQlaKtgWRJElY+ZoiIg+pfq9OlP4i18gZFVASGycwD1CkSu2TbX6QT1EM2jxE4A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=g/pCU9nS36AKkyeJkAtiX20MPHb/1e1IP6RoCLFaSWg=; b=lxJtFvkJefL5/kkD20zts+JsS2K7MKagsCGTjQhjKUPTVfCPe99ClajaJldrjS+SwXOgRs7WP2v1ak9xWeL7xnDHxtzJCa9wa1qjRL/+zahhB0OfEyIJvX94R5NjmyWAKI/f5c5l5nwdhLlxCm8vSZf/h+u/xgAGx0LZ/2FJwLDF0JPeJz8C9VLbA5VZXv+keC9M3bJXqbWsvFz9etmPnxxHY8jhEwKN3869HDYTJX/bIxndkpoR7H4ocDRrDIKdY5/ruGx5ZL+FuCRb9wew/BfHLYyCE5fCehhKH24AxSzGe3qm4KAQm/LV6VpKld47zFisjMRx/LurfS9RZg3IDQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=none; dmarc=none; dkim=none; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=hotmail.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=g/pCU9nS36AKkyeJkAtiX20MPHb/1e1IP6RoCLFaSWg=; b=SUBmjxSfdEZuUW0RMTR272KS0TgE+ANadJKfjwSjJygQANBE9s6cFU818l5LPLGgyUB6O+dM/iv4OnmKu5kaWWzVe0sDcbPLkZIBE2BIVjdUhIw4IU2sj93vV/RM2RtF0LCpB8gIqMacjGxJNnyPv2fPrpgMFNZf+/CTaAtGDK0EdoLdPWhn1Kw7b3TuI68KfXE93piwUIMkJXCfOoHYn9XViaFw6zAGEWK8RtJCfb652Fvj0+crwdltlnomaIOed4yrk5wDUcJOTVH2f/C45MIz+QWafadlL/1zlcyjb3NTA5h3o5mHt3XPTAc/B+Gav1DHes0EIuO08+FA4XLpVA== Received: from CO1PR11MB4770.namprd11.prod.outlook.com (2603:10b6:303:94::19) by IA0PR11MB7401.namprd11.prod.outlook.com (2603:10b6:208:433::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6086.26; Fri, 17 Feb 2023 09:06:29 +0000 Received: from CO1PR11MB4770.namprd11.prod.outlook.com ([fe80::ad84:7cc7:dc69:fe94]) by CO1PR11MB4770.namprd11.prod.outlook.com ([fe80::ad84:7cc7:dc69:fe94%6]) with mapi id 15.20.6111.015; Fri, 17 Feb 2023 09:06:29 +0000 Message-ID: Date: Fri, 17 Feb 2023 02:06:28 -0700 User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:102.0) Gecko/20100101 Thunderbird/102.5.0 Subject: Re: hard to read handbook.pdf in text system Content-Language: en-US To: stable@freebsd.org References: <1865c3f2a77.d8c426ef98619.7810515437835370312@zoho.com> From: "Edward Sanford Sutton, III" In-Reply-To: <1865c3f2a77.d8c426ef98619.7810515437835370312@zoho.com> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-TMN: [XZqUJmvMZrnHfGLPMA6HMJefqrUgt9Oq] X-ClientProxiedBy: PH0PR07CA0056.namprd07.prod.outlook.com (2603:10b6:510:e::31) To CO1PR11MB4770.namprd11.prod.outlook.com (2603:10b6:303:94::19) X-Microsoft-Original-Message-ID: <40617bbf-bd13-d752-e67f-e8c30b8e74bf@hotmail.com> List-Id: Production branch of FreeBSD source code List-Archive: https://lists.freebsd.org/archives/freebsd-stable List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-stable@freebsd.org X-BeenThere: freebsd-stable@freebsd.org MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CO1PR11MB4770:EE_|IA0PR11MB7401:EE_ X-MS-Office365-Filtering-Correlation-Id: fe3b58ca-f6fd-4c15-8ff4-08db10c641a3 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: i1IFsfBy+fKkZ0NctUyPp//mEHE9EJNnDr/NoL+6iMq5cy8Yc08nD4r2dLpsYwvX6ILsEE07GcFL37zdnLBOXsfsvzvcCHBRJYDsYOit3eTTK3WQM/zyM0bTzV1zW+4xDpdMOFyQjWgpSQzvJZnGQEkoVX4NbMKcOJiDxXQMahp2ernLBbDqjRXgYwi3OtzhDcIjIREw97ltPD+vVD7jP2kC1GBVrk0NGL+qFAn7dDKnooMwB6yK5himXITH5e/xqJGILUr3V98ROcamwN25snPH9kb4AAUXK1d0cRoAMPP32w9BDh0Y+Da43l8K98MmyV3P3A+r/L/hOLhCyWrVXi9xUGGsXk2l/CWus68zOn9AHxRYqlx+i3+DPoaISSjWZpVZKPl588XJYEgasc5DlK0aPrGNVzusGJ0d2fv9UG3KuzocK/+1I07vtpRx79Iym5CGKaRQ/So4N17TIF4LxGliixu1eRTxXSi2YaTqVavnvxUBz/YPhxML90HRTQZ+EnvFUgW783w32lEhJEX10h4884ehBGcB1wCBmrTiD5qhfVRdvTYog3KIVsSIh4Ds3GoGh1jasSGCzeB+kH7eywzGsokRzUj9x/HUCaGAJHixCxRP7ggdmiyo00GD5bTvOvewc6EsnQHS9gHcAsBorQ== X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?c0dZK1JuZ1Vpbjh2VUx3akg5NXp1S1drdzFNbkYzdDRwMURYWmUzZ2lMNGdx?= =?utf-8?B?U2tpdHVNN1B2M21sSytIczBtRzdHK3czSzI2STFMRVJwM1dIUW9YbW1vdHVn?= =?utf-8?B?N3hJZEkzbHdnbWE0bDJkd3B3ckxjOUx2aytReVZ2RVhSL3pOTklWV1NXOHBQ?= =?utf-8?B?T3U5Z3c3UFdXRDhXNHVXemJVWmdIcEpMVDFxcEx6L3JBd2VldWNHSWhLeTM2?= =?utf-8?B?YWkwTjA5S3VaMGVJalZYc1FUWWtHSlZSd2U2TVcyMVM3cVJibXlzWXRwL2Yv?= =?utf-8?B?U3M0Q3V2MnhISndieFdXVk9lNFFJU1VLOEhUS29HREt0R1FDSDZ1TzFoUHFr?= =?utf-8?B?NllDV3hmQURnK3FtY0pHMlNjMXpNdTBlMU5oTG0rYnlrbTJEbDZBOHZ5bzNO?= =?utf-8?B?dW1HMFRiZmRsMkFOU0VsUDByWkRBNUsvMldyU0dCRjU4Z25ITCtNOHdvSTFT?= =?utf-8?B?cjV6TURmSVhKWUhoanV0cUhSTVpMRVhpdk90VlptN2x0dExTQVdQT1RpeFdD?= =?utf-8?B?OGV1OUhCSkNic0xaUldpMnlEd1VIb0NRTE1tMGdRQTgzK3RrTjRodFQ5Lzdn?= =?utf-8?B?MHBNcnVhanNBTVM1NlFsTFl2UXZDaGxrMUQwVW9XQW1sVjlwMW1TNW00Vkdo?= =?utf-8?B?NDltTnd1aEZpVTJ2S09RTkdvd1FkNUVpL1AxN0pMTGFFdGVnekk0bjFTL3hl?= =?utf-8?B?TFBabStHRDZLL2Zpei91TnZZZ2lOdmJ6QVVUd3FTUm4wd3VyYks4VXZsdVBF?= =?utf-8?B?SnBtbFZlclRsdGtXNlIrNXBBaEgzS1phRnhvYVhRSGdWdndIUGtOZlpvL3JT?= =?utf-8?B?SGpsUStvdlV0YnNidWt5SzZ5NXVjNUJxNmRIT203OXh3cHl3SXVHMTdHbEdr?= =?utf-8?B?cnJvenhhZVppTUhjcno5ZTlxRktVUU92MGVpanpEd1F6amhSRnA0dldIZkpR?= =?utf-8?B?MkV3UjArenZZY0w0MXArUzk2N2dlN2ZOYXVLUGF5MUhKb2RWck16QXVuY2lE?= =?utf-8?B?R1JQQmJIRkxVZFhZbHh2M0RBVjk5WmlEY3lRN2ZzQklFbGtpaFBWU2R0T1FC?= =?utf-8?B?TjdtYWkwVjViNGJ6d2E5eEJyZzZmUGNUZHZMRWg3V2t0MFdmbEg2aGt1dnJs?= =?utf-8?B?dGhtZUlSdE1EeWJNNldzRWkraTlyT09meVNRQzMxWmR1OENYUS9UeUVVOTRk?= =?utf-8?B?d0lTcUZpL0tPZFhUbmdEQ1RhcnlZdlc2ajJOTGJGNUJKcDBtSEE2UjZzWGN4?= =?utf-8?B?MVZ4UFo1SWtBcSt0WjMxRnZhdXU1Y1hLTDEzbjlZRnBsTDc0ZUtmZjNSTjl0?= =?utf-8?B?T3l4L0JTMGJsNGMrSEVPbVByOGNyaDUxa3FibEM1SUh3SklxRE1DaDdDQmgv?= =?utf-8?B?bXc4Qk9MMUZNZFNxUTZ5NHlxTTA1RUU0QUVJb2ZtK3ZWNGFBTzFNOTRqMldk?= =?utf-8?B?NWlQYTEyU2lLVi9oZWs3VTZwV0g3RmZSNUFGUEFUNkkwQ2pYdCtJZVFlalhp?= =?utf-8?B?aWtTWFNjcjlXL1pnQUZ0OEI1STBidDIycW44bW5POFRNeVd0cjBHTFZDcjhl?= =?utf-8?B?NnNFNTdyNjZWZjVBQ3gvRk90MTVXSEpEUnlXR2J4Z3NsV0RLOWMxNnFIekky?= =?utf-8?B?QlV0cHY2ZVh4cHo3dks2V200U0IxMHZGcVdabXMxczRsYW1PQ0tpelhVRkdx?= =?utf-8?B?RExuNjdpRmZ6eFpCNVNrdm5peWx6NVFCZWVuY1hkdERvMDRoaWh4UHN3PT0=?= X-OriginatorOrg: sct-15-20-4755-11-msonline-outlook-e8f36.templateTenant X-MS-Exchange-CrossTenant-Network-Message-Id: fe3b58ca-f6fd-4c15-8ff4-08db10c641a3 X-MS-Exchange-CrossTenant-AuthSource: CO1PR11MB4770.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 17 Feb 2023 09:06:29.6384 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg: 00000000-0000-0000-0000-000000000000 X-MS-Exchange-Transport-CrossTenantHeadersStamped: IA0PR11MB7401 X-Spamd-Result: default: False [-2.50 / 15.00]; FORGED_MUA_THUNDERBIRD_MSGID_UNKNOWN(2.50)[]; ARC_ALLOW(-1.00)[microsoft.com:s=arcselector9901:i=1]; NEURAL_HAM_LONG(-1.00)[-1.000]; NEURAL_HAM_MEDIUM(-1.00)[-1.000]; NEURAL_HAM_SHORT(-1.00)[-0.999]; DMARC_POLICY_ALLOW(-0.50)[hotmail.com,none]; R_DKIM_ALLOW(-0.20)[hotmail.com:s=selector1]; R_SPF_ALLOW(-0.20)[+ip4:40.92.0.0/15]; MIME_GOOD(-0.10)[text/plain]; FROM_EQ_ENVFROM(0.00)[]; RCVD_IN_DNSWL_NONE(0.00)[40.92.23.40:from]; ASN(0.00)[asn:8075, ipnet:40.80.0.0/12, country:US]; FREEMAIL_ENVFROM(0.00)[hotmail.com]; MIME_TRACE(0.00)[0:+]; MLMMJ_DEST(0.00)[stable@freebsd.org]; RCVD_COUNT_THREE(0.00)[3]; RCPT_COUNT_ONE(0.00)[1]; FROM_HAS_DN(0.00)[]; RWL_MAILSPIKE_POSSIBLE(0.00)[40.92.23.40:from]; DKIM_TRACE(0.00)[hotmail.com:+]; DWL_DNSWL_NONE(0.00)[hotmail.com:dkim]; TO_MATCH_ENVRCPT_ALL(0.00)[]; FREEMAIL_FROM(0.00)[hotmail.com]; TO_DN_NONE(0.00)[]; RCVD_TLS_LAST(0.00)[] X-Rspamd-Queue-Id: 4PJ5XS3HP9z3v8g X-Spamd-Bar: -- X-ThisMailContainsUnwantedMimeParts: N On 2/16/23 15:01, Paul Dufresne wrote: > I have installed very recently from what was probably: > https://download.freebsd.org/snapshots/amd64/amd64/ISO-IMAGES/13.2/FreeBSD-13.2-PRERELEASE-amd64-20230204-d07eb716f35d-254363-disc1.iso > When I got at the end of installation I choosed to install the handbook. > When I booted on the system, I first searched in my home directory, then in /root, then after a while I saw the > link to it in motd (message of the day) after logging in. > I navigated to said directory to find a handbook in pdf format. > So I installed lynx, and read the handbook online. Was able to get to a working well enough graphical system. "https://download.freebsd.org/doc/en/books/handbook/handbook_en.tar.gz will get you the html handbook as a download. > Other people have remarked the oddity of the thing (to expect people on a text system to read the pdf file that explain how to install the graphical system). I feel the same. If I recall it used to be readable in text form though there were issues due to images instead of ascii art to express some concepts but I still found it useful. > I am asking here because you are supposed to be interested in 13.2 development at this time if I understood right. > But maybe I am suppose to ask to documentation team... unsure. Recent bigger changes were moving to asciidoc and git for general documentation management. Presume those friendly folks would know if asciidoc means we may see more formats available including console compatible documents again. If they don't speak up here, the ones I've interacted are friendly so may know if its a bug, current state, or the expected norm. > My wish would be that the installer would install a text version of the handbook. I've been lucky in that times where I needed to refer to the handbook to fix what I broke, I had some way other than a local copy read through a GUI to do so. Sometimes that has been when the system was left in single user mode where I was lucky if I was beyond mounting /, let alone /usr. I'll take any tools and documents I can get if ever stuck at such a point so count me in for both that and it being viewable from installer (even if no fancy graphics or a bad but meaningful ascii art substitute. Admittedly its been a while since I saw the install media and had any serious unexpected single user fixing to do.