From nobody Sun May 12 21:30:22 2024 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=none dis=none) header.from=gmail.com ARC-Seal: i=1; a=rsa-sha256; t=1710731150; cv=none; d=zohomail.com; s=zohoarc; b=fjT74rtkw6yGWq0RTn4tR5BgdJGpK9fgSTzcN4KpWicN3NrRMiC9jXRM/5Ll9FLcBIEIdOy/Jn7SkKnMJ6SaLBic0vc30TD5Syb8y+xmeytXQfysckuG/KikV6illgaj+uzMc9wSsJ91EBMFEuiD3FUEQC9KXzpC5C0ooKPKWq0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1710731150; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=cfL9cENqmsBlmvoSOl08CkdXFEA/4uL3lNvjfs+j+6o=; b=J+MZhMOdMCLIs23lNl5W/Udh/scIppyrtVi7+3V9yH3KTiKrVrXlUG0oD3B3sMtFigz7GQ2HmipFw8n20ZqxQS1vQBNHw9WU9y8PdaW/qBq+4mVI7bRByiVdL1rOd6KngKHqOF23zYn4DZa27snOyd7eaEzdkBeg0yMLlfl+/mg= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1710731150549808.7814679061138; Sun, 17 Mar 2024 20:05:50 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rm3J7-0004ux-7z; Sun, 17 Mar 2024 23:05:01 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rm3J3-0004uV-4a for qemu-devel@nongnu.org; Sun, 17 Mar 2024 23:04:57 -0400 Received: from mail-qk1-x72c.google.com ([2607:f8b0:4864:20::72c]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rm3J1-0007FG-EH for qemu-devel@nongnu.org; Sun, 17 Mar 2024 23:04:56 -0400 Received: by mail-qk1-x72c.google.com with SMTP id af79cd13be357-789e70d7c07so154403285a.1 for ; Sun, 17 Mar 2024 20:04:53 -0700 (PDT) Received: from localhost.localdomain (dsl-10-148-142.b2b2c.ca. [72.10.148.142]) by smtp.gmail.com with ESMTPSA id c27-20020a05620a11bb00b007882fe32acasm4143505qkk.3.2024.03.17.20.04.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 17 Mar 2024 20:04:51 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1710731092; x=1711335892; darn=nongnu.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=cfL9cENqmsBlmvoSOl08CkdXFEA/4uL3lNvjfs+j+6o=; b=mCFVQZeGNGQlJuHbGf1onriKhDmuyjidnYoNyv/krIea1rTZfr9WzolkJFh0yakU5o LblAFh43fWKOlWrzRsTWUW+5NSrfaKj0bbi+sP41ESb90rEUzpQDMiEnpivIYeLPMv6/ BxnEKTyj8TN0VAtUGlwtEw04SnugaV+yLa7s8ramng2HQcd0yTlspwoH36+oJh41lHOL o8SYKjvPJQuIo1jBRFQbxNl43Kj/O3oww1kdwe+pLZKeWs7VVRVmNMMpGm0/zOn4++ee z0zGtSBN0JYZGUcpX8iKczq8KH3FX8b+aEUY2BIdW+rht1OLZ/CUGfFutsFOGCf5CJ+d oSVA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1710731092; x=1711335892; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=cfL9cENqmsBlmvoSOl08CkdXFEA/4uL3lNvjfs+j+6o=; b=clgT/QaW2pezK2SU8utRJk1AZ/sqfF4oerJ1g5T5oFt7w0a2vzVK3p1DvXiQTV8/zV AET9IdVu4WuuRF7w6N95065JVom9Ntgi9DkmZFC0YKeYdJBSINiF9jEx8ZPZo2yD7uop 34Z3D+Z/lfpLdWy8UOBX5D+wyHKQ0CiZzezvxbkuIcxQMVOviCmD4+d69id4vRerxR2r mguI7Q7NbMngwOMZLNcgxvtGLHLJCgSwO4VitkCxw9O/QCo0XAd5419yfDG3MUS6ygGE PCqk7hOwKyF7Lh61qS7mGQy4e6qHwmvCL8IZjoMYr+LKY1GxP1HZPFCHaVbKDKy6IUm8 ePtw== X-Gm-Message-State: AOJu0YzRkdsl6kar69tOMYayNQzCEVELSW+fKpA8nwGaFMa+umbZoFWr W6ZyGY2c5I/u4nWf6pIIB3UU3VGvKqykMXtSZVmnhcWuxTE/uPBFYGjonibUv08= X-Google-Smtp-Source: AGHT+IHA49RE6uuHEpeP/8oUo5Px+asxcZ4g+iMpJ7K/j6dKHUfU8WB1TSV4EF4d2qX18d6FXdDwFg== X-Received: by 2002:a05:620a:124d:b0:789:e26b:50c with SMTP id a13-20020a05620a124d00b00789e26b050cmr10295863qkl.77.1710731092340; Sun, 17 Mar 2024 20:04:52 -0700 (PDT) From: Maxim Cournoyer To: qemu-devel@nongnu.org Cc: Maxim Cournoyer , Fabiano Rosas , John Snow , Paolo Bonzini Subject: [PATCH] build: Re-introduce an 'info' target to build a Texinfo manual. Date: Sun, 17 Mar 2024 23:03:24 -0400 Message-ID: <20240318030437.17503-1-maxim.cournoyer@gmail.com> X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=2607:f8b0:4864:20::72c; envelope-from=maxim.cournoyer@gmail.com; helo=mail-qk1-x72c.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @gmail.com) X-ZM-MESSAGEID: 1710731152778100003 Content-Type: text/plain; charset="utf-8" This reinstates , which was committed at some point but reverted many years later in cleanups that followed the migration from Texinfo sources to the ReStructuredText (RST) format. It's still nice to leave the option for users to easily generate a QEMU manual in the Texinfo format, taking advantage of the Sphinx texinfo backend. The Texinfo format is structured and info readers provide advanced navigation capabilities such as jumping to indexed topics or nodes and is usable even in environments lacking a graphical session. * docs/meson.build (texi, info): New targets. Signed-off-by: Maxim Cournoyer --- docs/meson.build | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/docs/meson.build b/docs/meson.build index 9040f860ae..2ae7886fcb 100644 --- a/docs/meson.build +++ b/docs/meson.build @@ -98,4 +98,26 @@ if build_docs alias_target('sphinxdocs', sphinxdocs) alias_target('html', sphinxdocs) alias_target('man', sphinxmans) + + # Add a target to build and install a Texinfo version of the QEMU + # manual, if 'makeinfo' is available. + makeinfo =3D find_program(['texi2any', 'makeinfo']) + if makeinfo.found() + sphinxtexi =3D custom_target( + 'qemu.texi', + output: ['qemu.texi', 'sphinxtexi.stamp'], + depfile: 'sphinxtexi.d', + command: [SPHINX_ARGS, '-Ddepfile=3D@DEPFILE@', + '-Ddepfile_stamp=3D@OUTPUT1@', '-b', 'texinfo', + '-d', private_dir, input_dir, meson.current_build_dir()]) + sphinxinfo =3D custom_target( + 'qemu.info', + input: sphinxtexi, + output: 'qemu.info', + install: true, + install_dir: get_option('infodir'), + command: [makeinfo, '--no-split', '--output=3D@OUTPUT@', '@INPUT0@']) + alias_target('texi', sphinxtexi) + alias_target('info', sphinxinfo) + endif endif base-commit: ba49d760eb04630e7b15f423ebecf6c871b8f77b --=20 2.41.0