From nobody Thu Oct 07 18:27:00 2021 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 1980A12DCB49 for ; Thu, 7 Oct 2021 18:27:12 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: from smtp.freebsd.org (smtp.freebsd.org [96.47.72.83]) (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 "smtp.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4HQKYD05Cbz4cmN; Thu, 7 Oct 2021 18:27:12 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: from mail-vs1-f54.google.com (mail-vs1-f54.google.com [209.85.217.54]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) (Authenticated sender: carlavilla) by smtp.freebsd.org (Postfix) with ESMTPSA id D1FB62AE35; Thu, 7 Oct 2021 18:27:11 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: by mail-vs1-f54.google.com with SMTP id p2so7747324vst.10; Thu, 07 Oct 2021 11:27:11 -0700 (PDT) X-Gm-Message-State: AOAM530kN5UiOKZa+rcHVpWVhr2vHcM7xlpcw/HaEfkLFfnzRXlwXQh3 y90uo4Q3OGHStzh5VpXCdTHZdpZ08Jm6szbHcac= X-Google-Smtp-Source: ABdhPJw1+IGQP2/cxg2g3GA2aGX0qURJlZmoEADVqsxoWjyxgKGwMj5q/7LQMfxPOsXemhkwPdjVHurbFGvrqW5RMKY= X-Received: by 2002:a67:ed5a:: with SMTP id m26mr5840911vsp.35.1633631231399; Thu, 07 Oct 2021 11:27:11 -0700 (PDT) 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 References: <202110062359.196NxFqS079143@gitrepo.freebsd.org> <0595c299-55ed-17c4-74ac-16a804541473@FreeBSD.org> In-Reply-To: <0595c299-55ed-17c4-74ac-16a804541473@FreeBSD.org> From: Sergio Carlavilla Date: Thu, 7 Oct 2021 20:27:00 +0200 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: git: 5a5db32f4a - main - Fix build after c8e8be58e580 To: John Baldwin Cc: "Danilo G. Baio" , dev-commits-doc-all@freebsd.org, doc-committers@freebsd.org Content-Type: multipart/alternative; boundary="0000000000003ddb8d05cdc769fa" X-Spam: Yes X-ThisMailContainsUnwantedMimeParts: N --0000000000003ddb8d05cdc769fa Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Thu, 7 Oct 2021 at 18:23, John Baldwin wrote: > On 10/6/21 4:59 PM, Danilo G. Baio wrote: > > The branch main has been updated by dbaio: > > > > URL: > https://cgit.FreeBSD.org/doc/commit/?id=3D5a5db32f4a1e3f507cdc55f92d53e63= adbb4f022 > > > > commit 5a5db32f4a1e3f507cdc55f92d53e63adbb4f022 > > Author: Danilo G. Baio > > AuthorDate: 2021-10-06 23:57:27 +0000 > > Commit: Danilo G. Baio > > CommitDate: 2021-10-06 23:57:27 +0000 > > > > Fix build after c8e8be58e580 > > It used to be possible to use 'make' in individual books or articles to > test > things, and also to only build just html versions and not be required to > build PDF. Apparently our new system doesn't permit either of those, so = I > gave up on trying to test this pre-commit. > > -- > John Baldwin > Hi John, This is completely true, at the Doceng we are aware of this problem and we are working on a solution. In this patch[1] each document would be handled as an unit. What this means? This means that you can enter the folder and execute =E2=80=9Casciidoctor [name-of-the-document]=E2=80=9D. Usually =E2= =80=9Casciidoctor _index.adoc=E2=80=9D So, when this patch will be merged, you will have three options to build the documents: 1. Build the complete documentation. 2. Build only the document that you touched. 3. Use a plugin in any IDE to see in realtime the changes. In my case (with this patch[1] applied to my local) I used Visual Studio Code with this plugin [2] And, what can you do in the meantime? Well=E2=80=A6 you can continue using = the documentation as is. Or you can use AsciiDoctorLive[3]. Sorry for the inconvenience. Bye! Hope this helps. PS: I have an email to answer about recording some videos to help people to see how to configure the tools. I=E2=80=99ll answer it this weekend :) [1] https://reviews.freebsd.org/D31926 [2] https://marketplace.visualstudio.com/items?itemName=3Dasciidoctor.asciidoct= or-vscode [3] https://asciidoclive.com/edit/scratch/1 --0000000000003ddb8d05cdc769fa--