From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-0.1 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,FREEMAIL_FROM,UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 26625 invoked from network); 7 Aug 2021 11:46:08 -0000 Received: from 1ess.inri.net (216.126.196.35) by inbox.vuxu.org with ESMTPUTF8; 7 Aug 2021 11:46:08 -0000 Received: from mail-wr1-f51.google.com ([209.85.221.51]) by 1ess; Sat Aug 7 07:39:09 -0400 2021 Received: by mail-wr1-f51.google.com with SMTP id k4so1482871wrc.0 for <9front@9front.org>; Sat, 07 Aug 2021 04:38:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=date:from:to:subject:message-id:references:mime-version :content-disposition:content-transfer-encoding:in-reply-to; bh=L+c+tS+FOXExPWHmCfJnZgRvvjVNicCYndBVYvGbQfY=; b=GeSVeBcblUks3rZnRcPYGhnWcB0faPYAnrhQuQMxxI/OCDEt8OALqf/Lrkng0ZYQSv u8xxIjyBl2H/eYcXBbT9iuf6br5Is3Lt4o3lDWBYLKTMsub/pOli/SEVxQkevwTJ0iSe 3foeaT92OZxQjGZpholvMSGPOG6yxKIEezWXgvfo1UTzPVm4Cm5KDP0y6KhsWdT2FF2g UA5L6MU7M8souFbdrdewBrRjS0suVlOVkNJzzgskvB2ZcqJeeIFvXHtx+VO4uZW687M+ g9MT/ozBlSrDzTMwpITTWKjXF/cJHGpnFDPL5qGnblrOf6KCIgLZCLv+Bw9msqqd4vnZ n9SA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:subject:message-id:references :mime-version:content-disposition:content-transfer-encoding :in-reply-to; bh=L+c+tS+FOXExPWHmCfJnZgRvvjVNicCYndBVYvGbQfY=; b=VKfw7WpInMqSdPJx89JvM4CtGep3XrE6jLbJHaERqJbAxbl68ZTPm3bHWbCqyuhOD0 m69KGSE6UpuhxWXX7FZbxKwC7qw5qwK3EyUpCg0EnbK+/E0N5h2LQG4q4SqUPLFqfIM3 08BaxCQI+v9XOVJ8+HnhWzzxQCpf3DoCcJwAR+mNSiffiL6hMpUDtxuMmjzla7YX1c+x ozOMS4j31+cRxr/yItm32IOKBX7f31jCppbIMmQ97ZdXp/f9Ka0QWBElJClbCzrE6ROu 67goM8BsRw2ETiqGLe3/tvM0bpLv711bXonljgWymXsIUwhL2JnWaDUIvkXJSFgAl3Ze NzjQ== X-Gm-Message-State: AOAM5315hUgaz1x/XaZ7O0787JuwuuicAVgvCfU91pF2JFs2II49+lWV Zhc32Er8O+9x5ikaY2V8kwPJbg2rkxI= X-Google-Smtp-Source: ABdhPJxDG1HPoX5Y4UN6zXm1sIWf7vTrAdg131ib+HweMnn359rknevVN288kj3zCx9Z+srPfkDi3A== X-Received: by 2002:adf:f202:: with SMTP id p2mr15457395wro.240.1628336336321; Sat, 07 Aug 2021 04:38:56 -0700 (PDT) Return-Path: Received: from beryllium.local (dyndsl-095-033-224-194.ewe-ip-backbone.de. [95.33.224.194]) by smtp.gmail.com with ESMTPSA id n3sm11172274wmi.0.2021.08.07.04.38.55 for <9front@9front.org> (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 07 Aug 2021 04:38:55 -0700 (PDT) Received: from localhost (beryllium.local [local]) by beryllium.local (OpenSMTPD) with ESMTPA id 3bf25742 for <9front@9front.org>; Sat, 7 Aug 2021 13:37:27 +0200 (CEST) Date: Sat, 7 Aug 2021 13:37:27 +0200 From: Humm To: 9front@9front.org Message-ID: References: <41714DC4-F599-485D-9E19-8282E0E4AA33@stanleylieber.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <41714DC4-F599-485D-9E19-8282E0E4AA33@stanleylieber.com> List-ID: <9front.9front.org> List-Help: X-Glyph: ➈ X-Bullshit: shared asynchronous hypervisor-oriented map/reduce optimizer Subject: Re: [9front] 9front Programmer's Manual Reply-To: 9front@9front.org Precedence: bulk > what specific changes did you have in mind, and what is the purpose > of the exercise? I had in mind either fixing and updating the means of building big volumes containing the documents and the man pages or removing them completely. Building those big volumes probably wouldn’t actually be too useful, since it’s easy to read everything on-line. It might help with reading stuff with, say, an e-book reader (as sirjofri mentioned), but even then stuff like title pages, a ToC, prefaces, and maybe even the permuted index wouldn’t have any purpose. If the manual is to be printed, for whatever reason (like people finding it easier to read stuff on paper), as you currently do with one half of it, I like to have the means of building the print edition (a generic one, without colorful covers and custom page size adjustments) in the system. As it is, we have a build system for big volumes somewhat usable for print, but it refers to Plan 9 4E on the title pages and in the first preface, doesn’t work well, and produces bad results (mix of troff default 8.5*11i and ms default 8*11i) without easy means to customize the page layout and type. Whatever the outcome is, I don’t want to keep something bad like that. Updating the documents or adding new ones is not a primary concern of mine here and can be done either way. What I have done is create a working version of that, my /n/tcp!9p.zone!9991/humm/^(print.pdf docs) . No big changes of content, just the name “9front Programmer’s Manual,” better page numbering, and easier control of parameters of the final result. -- Humm