From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mx0a-00154904.pphosted.com (mx0a-00154904.pphosted.com [148.163.133.20]) by sourceware.org (Postfix) with ESMTPS id 4E9883857439; Fri, 11 Jun 2021 18:48:45 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 4E9883857439 Received: from pps.filterd (m0170391.ppops.net [127.0.0.1]) by mx0a-00154904.pphosted.com (8.16.0.43/8.16.0.43) with SMTP id 15BIgWru017294; Fri, 11 Jun 2021 14:48:39 -0400 Received: from mx0a-00154901.pphosted.com (mx0a-00154901.pphosted.com [67.231.149.39]) by mx0a-00154904.pphosted.com with ESMTP id 393v174c53-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Fri, 11 Jun 2021 14:48:39 -0400 Received: from pps.filterd (m0133268.ppops.net [127.0.0.1]) by mx0a-00154901.pphosted.com (8.16.0.43/8.16.0.43) with SMTP id 15BIjY14030946; Fri, 11 Jun 2021 14:48:39 -0400 Received: from nam02-sn1-obe.outbound.protection.outlook.com (mail-sn1anam02lp2045.outbound.protection.outlook.com [104.47.57.45]) by mx0a-00154901.pphosted.com with ESMTP id 390pw2e9ck-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 11 Jun 2021 14:48:38 -0400 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=h37AEtDxuq5bvOcSdM631JC6BM51mjzY3RHgsHseLrEYccIb33QbFxvA+5BBRd1B74IbZHV9XqoSyIyP9pMU+CtgLL/jJILjDk5X2SqDgRs6A+FjBPUhCsvnTtyViVcTxEPMAv7BP1N277Of5unKus6vyeiNWGOMXELbdjLDFAgH0d6Eqk0QsCiqNOsG/hrkOOYPLP9FdJA1ILuj+sa7AA8zVSkFrkYHlkgXE5AeZl336tR/m9b2FvMUNklYw3qG+htw+Hs1so8C+dmxOjfiONWGiFeW0lRiP1ErYPX0L/DfPBfsNDVg2dPd3FdA1ZU5AGzil32CQNBE/cshqDPmWw== 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-SenderADCheck; bh=8Vvva7OBTOYaPKE4MrFZmGpJNHpZzdQ6aFJgCHP5F8A=; b=XtFlevoTiqxNUkFKdNyaBQWcB+EplT4rEg7CA/WhaWYoAenc75TvBFEtmQfEipDpHdg2BqrA23Pxc8DjpwJcEA4420Tmqx30mCzNzLti46JzZkytFlN82W4JJKhzJlmdyewx2yMjVyUJ2+gZIrqBCM7hJWmvYVZKAdsMCZW91iFGna3VWKKiX7tjbWy3nVwBRYIxwrmejoBUEoM5DZZS9RtwFsdIK0/kVi7G51dx9Fy3sMQQ652PmBTb+xf6HiAmiXrfF+2ODphIgbZrylGqFw//6Eoid2XPMjKvKUlEvB8X29PAfXE1kG+TCE3AX0A06Rc3DILzCH6UCq6w4AwROQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=dell.com; dmarc=pass action=none header.from=dell.com; dkim=pass header.d=dell.com; arc=none Received: from SA0PR19MB4508.namprd19.prod.outlook.com (2603:10b6:806:b8::7) by SN7PR19MB4765.namprd19.prod.outlook.com (2603:10b6:806:100::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4219.22; Fri, 11 Jun 2021 18:48:36 +0000 Received: from SA0PR19MB4508.namprd19.prod.outlook.com ([fe80::b8aa:7651:8965:d582]) by SA0PR19MB4508.namprd19.prod.outlook.com ([fe80::b8aa:7651:8965:d582%4]) with mapi id 15.20.4219.022; Fri, 11 Jun 2021 18:48:36 +0000 From: "Koning, Paul" To: Joseph Myers CC: =?Windows-1252?Q?Martin_Li=9Aka?= , GCC Development , GCC Patches Subject: Re: GCC documentation: porting to Sphinx Thread-Topic: GCC documentation: porting to Sphinx Thread-Index: AQHXXvJils3cLtg7J0yVwgDJPRs00w== Date: Fri, 11 Jun 2021 18:48:35 +0000 Message-ID: <018A7C8F-0A36-499D-A64C-9C42D102B3E2@dell.com> References: <1446990946.2994.192.camel@surprise> <1a22bc37-3d48-132f-a3d5-219471cd443c@suse.cz> <3a2a573b-5185-fff5-f9da-6e5e39953ad6@suse.cz> <8641dc55-5412-fbd7-bafd-13604311f5ad@suse.cz> In-Reply-To: Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-mailer: Apple Mail (2.3445.104.21) x-originating-ip: [73.60.223.101] x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: d6968784-fbfd-4278-16ce-08d92d098520 x-ms-traffictypediagnostic: SN7PR19MB4765: x-microsoft-antispam-prvs: x-exotenant: 2khUwGVqB6N9v58KS13ncyUmMJd8q4 x-ms-oob-tlc-oobclassifiers: OLM:7219; x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: y2rawbJ1mZPaqDfU6WztZ+Sbp8Perh0qFetqmjx3ix+qBOkcrNUkRFr02SDrMgwh8JeTzwsta5CTge7KTPkME5mr2wWhoHfM+a62e0FgmDu3FRosC+vOoN1+x0BNdepJrM1xAdVTCekx1olCllvQpDE49s6gdkFfzHOeCWBRo2KwTJbvgXI/Rs9swfBmr+NlAgPdtUSpdzE8R1QgcDaG4i39A74WyJ0UL2eTZEbJdC6H+aRNHj5n4y/hwKsCsB67fB82PSXggwW3y5i6nyfTaNWi60Hl4WAkt/P2sfBsgjF9OukMxnijG4jlT9ZdBtkRHyPJwF/Ex0c9Md8H1PXXuXQjI1YnqiIJ3ELL3MfiCsg2ZiP8RSM6/kEpULOmgskSlgHA58ITro7ZoUaMTvFmKagnoLSfVAnJ3cfEtHlbCyxUuum91so9ZLioPsPYWKSoWFs6gOdQyt4F4BDxNAKmUIVcvi9zL7vsbRxIHAh+Vtp+q1R7Pe/DjOPMvPd2/BZF1ITuza46hh5zxK1PbEAkWK6diOUiych2pJddrLDrODfLp4RgM6k39Z18ynoEBBP+eX7T9Y0KR50P8eXYaxVivdwhNSc7KkqYSMQuJ/z7L0rr7cRemlJcC6FV53Qr0qblcB6sSVMLAztDhruu5H1BIMz9YiOhBEG+d9HlyJGFGTw= x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SA0PR19MB4508.namprd19.prod.outlook.com; PTR:; CAT:NONE; SFS:(4636009)(366004)(396003)(376002)(346002)(136003)(39860400002)(6486002)(33656002)(8936002)(26005)(122000001)(2906002)(71200400001)(38100700002)(4326008)(36756003)(2616005)(86362001)(53546011)(6512007)(786003)(316002)(8676002)(54906003)(478600001)(5660300002)(64756008)(4744005)(66476007)(186003)(76116006)(66446008)(66556008)(6506007)(6916009)(66946007)(45980500001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?Windows-1252?Q?zR0m9VcOeBrX+d++kA0/EGlO+14Ac2sgTwpltMEaQDd22y35AOnV+Akb?= =?Windows-1252?Q?BApPHKetJGrV4Q1L4TODqcEdqfPIq5N82axNU0LPdCUmJV0ECXe3m5n7?= =?Windows-1252?Q?zo8QgGG6MqEj7UIpAFpilGutUIbZImdnSvlXzSldqR37U1NGITqQu4Dg?= =?Windows-1252?Q?TeCjlbnNm0Pfuf1hZvdHb7N1Uk98EkK23BgMpYqmcClB2EKbZS9Aoy3o?= =?Windows-1252?Q?pD+4Ni3KpzWjZxWqauvHShEAmBbbBVuh12mWpx3iedq+vUyCExeMVuyF?= =?Windows-1252?Q?zDiGB8+wEqYH44cp7zuem5z+SgEH18YC1Ul5j8V9ZLrnvg7rpviuFCzm?= =?Windows-1252?Q?8tS5iVmVYgg8Ym+3L7l3TOhBe/3kZ39/+P1HZ6n+dy7ICC+y3Qf7lkEc?= =?Windows-1252?Q?YRG3VU/fTgUA1l7uGdxLSa5Tq2QTsdKiMBB81+95K9ePxPy9TthxejKI?= =?Windows-1252?Q?RU+Hcvb5Qd84VRNUXF4PC1iA9TmWJnzGXoqiiUtzTbUwoQn+aYMx/EFC?= =?Windows-1252?Q?QYBDqBT+LUwC+Dw9KKw0+tyr8FmGrqJrSmxgO2EvJqwdW6v+nJ8HhoDb?= =?Windows-1252?Q?+wcYkM1pCpr1u8Dd8q0EnLVBBSRSlGvnzX2Zm+6SBChIo9AeiYxNw78t?= =?Windows-1252?Q?Qn5LxBjNVXKU4BgZILev722vQOllEjYocfOEUZmzI0aEpYYP7KI0PBWl?= =?Windows-1252?Q?HZ0JU8SoPqcD0yOQVF/6mjFW+KrSihdDl/xD9MIgw+WAWukjgAvgjQY9?= =?Windows-1252?Q?C7TwhAWwK9cS0fL5+LxsPrmCQHtkfZYPbHgRd0UPIKusfrY2TF2Td4LM?= =?Windows-1252?Q?4MtZ92fP5Mrij178hYQRO2PrQQLsmGBcervXc7a38z+nfQcRfgBw4PhH?= =?Windows-1252?Q?qyGXJRnx+ITI6zC9ksgrjKrj6dwwenx5/+PUKQm4LiSKfbulxlM8jngZ?= =?Windows-1252?Q?X7U9j0PXaCstDdxSQKo8vMpR3V1WMrMUYvTNWwrnix2WfI2S3AdShp4p?= =?Windows-1252?Q?hDM/dUWvycE23XoYB7wY0L4qZB4Fh607+J6YYkFvbjT1nuQyunn2FByf?= =?Windows-1252?Q?szHPgj5Nwb+u0kE58WZyWcHoT5uXUp9vndnafIRdK+xXUINZ3J6vKjLk?= =?Windows-1252?Q?j4Rx6CEoTwlTeltqoYzs9DcHQum4ZmihmMOVo92Xx7mrjXspNeAfAH8T?= =?Windows-1252?Q?pC2POQpl/+Bqd3BtUAqJReQtzl40j5Kk2xgSv8NNhnYvMoUQ6Fj4i9yi?= =?Windows-1252?Q?mUc/Sn4WrQ0Au8OSTXkmLmxAiy9GP1IXTb1aVc42xafcP4r2M7zWZ0os?= =?Windows-1252?Q?6o/0Z2KpV7xfDwziQcWWzTpROzuN1bIuK261fiMUBWKiv1UjF3iRUecu?= =?Windows-1252?Q?PX9EKCmXcxKgRK0t2+h4LpW6UGJvXqq2xLwwW7MqOY5+2HbW3iuOdSHB?= x-ms-exchange-transport-forked: True Content-Type: text/plain; charset="Windows-1252" Content-ID: <367D384EEDACE641996B4E2673C8E803@namprd19.prod.outlook.com> Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-OriginatorOrg: Dell.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: SA0PR19MB4508.namprd19.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: d6968784-fbfd-4278-16ce-08d92d098520 X-MS-Exchange-CrossTenant-originalarrivaltime: 11 Jun 2021 18:48:36.0108 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 945c199a-83a2-4e80-9f8c-5a91be5752dd X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: eXrRFthqK38maPnrlG2a4XuvNzc+iyHyn6c4OlORnMDnk0Eh9qt/xnj7oWQ4Q2Kh7lp7DlYQyATmGbxjz2i87g== X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN7PR19MB4765 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:6.0.391, 18.0.761 definitions=2021-06-11_06:2021-06-11, 2021-06-11 signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 bulkscore=0 mlxscore=0 mlxlogscore=956 spamscore=0 priorityscore=1501 phishscore=0 impostorscore=0 malwarescore=0 adultscore=0 lowpriorityscore=0 suspectscore=0 clxscore=1011 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2104190000 definitions=main-2106110117 X-Proofpoint-ORIG-GUID: tB-PgwWTA-gH03y5TDXbNGTNA3N6McUj X-Proofpoint-GUID: tB-PgwWTA-gH03y5TDXbNGTNA3N6McUj X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 malwarescore=0 mlxscore=0 spamscore=0 phishscore=0 mlxlogscore=999 suspectscore=0 adultscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2104190000 definitions=main-2106110117 X-Spam-Status: No, score=-3.5 required=5.0 tests=BAYES_00, DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, RCVD_IN_MSPIKE_H2, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on server2.sourceware.org X-BeenThere: gcc@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 11 Jun 2021 18:48:46 -0000 > On Jun 11, 2021, at 11:50 AM, Joseph Myers wrot= e: >=20 > ... >=20 > "make" at top level should build all the info manuals and man pages, as a= t=20 > present (if a suitable Sphinx version is installed), and "make install"=20 > should install them, in the same directories as at present. >=20 > "make html" at top level should build all the HTML manuals, and "make=20 > install-html" should install them. >=20 > "make pdf" and "make install-pdf" at top level should work likewise. >=20 > "make install-html" and "make install-pdf" should put things under=20 > $(DESTDIR)$(htmldir) and $(DESTDIR)$(pdfdir) as at present. And in addition, it would be nice to have additional make and make in= stall- targets for other output formats that Sphinx can generate for u= s, at least some of them. "epub" comes to mind as an example I would like = to have. paul