From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from NAM12-DM6-obe.outbound.protection.outlook.com (mail-dm6nam12on2100.outbound.protection.outlook.com [40.107.243.100]) by sourceware.org (Postfix) with ESMTPS id 3BE6F3857C44 for ; Sat, 17 Oct 2020 22:48:21 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 3BE6F3857C44 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=YKwBLDVjzpA1ihTeOkDKTw5WXmWSmc6aM9MyAgV1FQBJyQrtkAWJ9yWtvmX6gg46VBy4+LSei9ewiR6zmCSo2XYk5fN4uCz2tM9v0Uw2W41n4Y0f4zOtYgUAXzDNTGHT3lK1DLTqrSz5sGnN9FF01Ss9ShdmTRXaaOFHtNVTQKRHm+HMoDtz7CY4e9j5CEipMkXGmgzaiUpryemmcobEZY2wACirUV5ZrnpQw/UruILA3F2rllC39T5/m8+qaPHyZqAhqok7kMuQBJ+MJDWKU9UNPqi0VxEh0RdrCNhAfFQkM2JsqeMyZb5ZXwzS06V/tgj3aYceNBOQhLfcwaVdhw== 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=+zEeXGHPavqZv8Aa0nCPeh8LsTs6nOmoWWuXJaUi1mU=; b=DwKKD32ak2JubPJZkCPnx+PY3O8/im3J20vRd45kIpUzvdt7p01GJughGU57kBqzmm1P/xpuZluPmlg1ludSNZQoNt8UwODWvmFpnUPFD2cZ3bASsZ3fOi+ekP1NgpLhZJrpl7vfhmyrMGEe9lUUtgP5dX/osi2xP5O0ureHqQvvZZjpVKaBjIWuP1Ub73mAHDHeVHdGayOR2/57lJJdwwvaj6XlruMhclw6PRgHiTkWf5lpbafVsSgX4YpXg2BsgUYQSfFL8YYoqBmT/r2ucdxR+hmw7Ova+xgrYDlykK65tgfeOWKJNnNDbPA0yUSp/1xhdMIoRLhuxZj5sD3FsQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=cornell.edu; dmarc=pass action=none header.from=cornell.edu; dkim=pass header.d=cornell.edu; arc=none Received: from MN2PR04MB6176.namprd04.prod.outlook.com (2603:10b6:208:e3::13) by MN2PR04MB6126.namprd04.prod.outlook.com (2603:10b6:208:e6::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3477.20; Sat, 17 Oct 2020 22:48:19 +0000 Received: from MN2PR04MB6176.namprd04.prod.outlook.com ([fe80::c144:d206:c369:af44]) by MN2PR04MB6176.namprd04.prod.outlook.com ([fe80::c144:d206:c369:af44%7]) with mapi id 15.20.3477.028; Sat, 17 Oct 2020 22:48:19 +0000 Subject: Re: curl new version docs advice and opinions requested To: cygwin-apps@cygwin.com References: <92223869-af86-ff0d-c2a3-7747814f8dfd@SystematicSw.ab.ca> From: Ken Brown Message-ID: <5efdeaf0-36bf-3fb7-5d43-0eaaf7ee2f04@cornell.edu> Date: Sat, 17 Oct 2020 18:48:18 -0400 User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:68.0) Gecko/20100101 Thunderbird/68.12.1 In-Reply-To: <92223869-af86-ff0d-c2a3-7747814f8dfd@SystematicSw.ab.ca> Content-Type: text/plain; charset=windows-1252; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit X-Originating-IP: [2604:6000:b407:7f00:590c:98fc:b845:b08d] X-ClientProxiedBy: CH2PR17CA0020.namprd17.prod.outlook.com (2603:10b6:610:53::30) To MN2PR04MB6176.namprd04.prod.outlook.com (2603:10b6:208:e3::13) MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 Received: from [IPv6:2604:6000:b407:7f00:590c:98fc:b845:b08d] (2604:6000:b407:7f00:590c:98fc:b845:b08d) by CH2PR17CA0020.namprd17.prod.outlook.com (2603:10b6:610:53::30) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3477.21 via Frontend Transport; Sat, 17 Oct 2020 22:48:18 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 7496b7bd-058e-494b-d837-08d872eebdfe X-MS-TrafficTypeDiagnostic: MN2PR04MB6126: X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:7219; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: FiJiumJ25e3Ijdy/OPAuk7kB/hJ7O+ldOGsFTPiDFftDlokUWmNU5i7lpyi+k7v+DCYraW1/abDGQrFN94q+sXDzbu/+NHWpUt4cedp0Sfl6J4Ml0Gt7OnsFffW9g1VEPpMNBobLopVpHwhCXt53kttpuy4q6y1j6BSqJdqEJi0MZVLdg1BPLtbVVcL0+v8MhUKlHigWGo0q+UUvSO4/M0HApqFnVkjWT9wEZc2BXnodmS8/DMwMvFe1zJN4QuZC1h3BdYJp6Lx3mJ/3+yZo+FZ1tjO/1A0/HUEk24dvRY1uYRccD1xTlVemE3nOgJmZRXiAv7OWLrS98N/O8I6gUGn2HxBG4rv5RlZjRvqxriMGy1hwNNMoGNaSpQ3hCP3o+UWiXy8/kkfW+zUaXPa3Oj5vqHcXd+bV7N5LkyBRZ0Ka4+qxevbG59c2N77ehhDI8mKtqY5jwQecOdyTRj106Q== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:MN2PR04MB6176.namprd04.prod.outlook.com; PTR:; CAT:NONE; SFS:(4636009)(396003)(366004)(376002)(346002)(136003)(39860400002)(86362001)(83380400001)(66476007)(966005)(66556008)(66946007)(75432002)(53546011)(8676002)(16526019)(2906002)(478600001)(31686004)(186003)(6486002)(8936002)(786003)(5660300002)(316002)(52116002)(6916009)(31696002)(36756003)(2616005)(43740500002); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData: PuZeWqaScZkJQmHR0ta4CncQvUzWMd40ylWaDsB6Dl26A3pVEKtF7KL4WOkvbg0xF5jzSzWZwVGq6MAK7+KydtO85D7NfV0jL4V6i8rpY4KZf+NxcOnK+JevecPfJLtXUVtnmU0mrQ/icIDMlm+lw2nc3GmPFUEJMopP0M0XM2kPuvLXhfeOaLj9RByohJnfgsmsPm55qlTTEsZxPRXnY5L8ol5KjqYb8XMUzJogAB3y4jzow1GSo/0O+SBAfaVBc9044AHKEJExvEXOAHMC6v3LuOjShC0ZcxGqDYDfM9A/6MQTqcbOBa4JZX9unv6BStDLTo7g4Vi0GoolbtnTGY/wKWxToZvhR3at5Cs4qX4RAjOl7D60M+iAnnklC466GI/v2aiMhOwfa+UdgNyM6K95bgpLV7vpFKSabbSwohrUwzzCpVyyXYIu9WPL6rigPGZxZuTeyNEgWHX3yfBFoNGUnC3i2dsOjSCvnTulMTvjHjhG4wM5pKWHwbXmPmGDXGv20WyJL4FAZa97/KqVbGHq6S/Ugka5ZJS3E6N3ZEk8navYaI23E3mj/i0A8ssxRAo858LVyQR5gFcXfytLuxsPJCVnFUmH+YNAI78P6EC8oaYZNeVJ0QAesDlxp7YEIzJAUki6i/t9flHarXHbzRt/mkhAZc92WVbMSdoXhzVfcI0p132kORDTzlMbTNf9+6RxJ7zYSkn6kXlkuJ/gbw== X-OriginatorOrg: cornell.edu X-MS-Exchange-CrossTenant-Network-Message-Id: 7496b7bd-058e-494b-d837-08d872eebdfe X-MS-Exchange-CrossTenant-AuthSource: MN2PR04MB6176.namprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 17 Oct 2020 22:48:19.3300 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 5d7e4366-1b9b-45cf-8e79-b14b27df46e1 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: Uwox1+VNIMoUFY8l+hIGpqkWYy9SS923y0f53dvsCuYETyfCM/zK4sKKfKf/x1LU4rFCNA5X4v7b06J9OFiVyA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR04MB6126 X-Spam-Status: No, score=-3.3 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, MSGID_FROM_MTA_HEADER, NICE_REPLY_A, RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H2, SPF_HELO_PASS, 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: cygwin-apps@cygwin.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Cygwin package maintainer discussion list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 17 Oct 2020 22:48:23 -0000 On 10/17/2020 5:38 PM, Brian Inglis wrote: > Hi folks, > > The latest curl version has converted some more docs to md and dropped some, so > I'm reconsidering what is packaged with the utility, what is delegated to the > -docs package, and whether that should just be included in the -devel package. > > The following extract from the cygport shows what was included, what I think I > should include as it is generally useful, and everything now in the docs > directory, such that everything else appears to be likely to be of interest only > to developers or maintainers, all shown with sizes below. > > #DOCS="docs/BINDINGS.md docs/BUGS.md docs/CONTRIBUTE.md > # -docs/DISTRO-DILEMMA docs/FAQ docs/FEATURES docs/HISTORY.md > # docs/HTTP-COOKIES.md docs/INTERNALS.md docs/KNOWN_BUGS.md > # -docs/LICENSE-MIXING docs/MAIL-ETIQUETTE -docs/MANUAL -docs/RESOURCES > # -docs/SECURITY docs/SSLCERTS.md docs/THANKS docs/TheArtOfHttpScripting.md > # docs/TODO docs/VERSIONS.md" > > DOCS="docs/CIPHERS.md docs/FAQ docs/FEATURES docs/HTTP_COOKIES.md > docs/MAIL-ETIQUETTE docs/PARALLEL-TRANSFERS.md docs/README.md > docs/SSLCERTS.md docs/SSL-PROBLEMS.md docs/TheArtOfHttpScripting.md" > > However, I am unsure whether I should still include the long and detailed > HISTORY.md and THANKS which gives credits, and anything else others may consider > generally useful. > > Also whether to include docs/examples/ C programs in -devel or -docs packages, > and whether I should even bother with a separate -docs packages, as all that > other information appears to be for developers, and appears not to be generally > useful IMHO. > > Lines Words Bytes Path > 9 33 315 docs/INSTALL > 12 65 353 docs/DEPRECATE.md > 12 61 510 docs/README.md > 19 67 602 docs/ROADMAP.md > 29 109 685 docs/MQTT.md > 23 141 917 docs/EXPERIMENTAL.md > 24 143 1090 docs/CMakeLists.txt > 39 181 1093 docs/ALTSVC.md > 32 210 1607 docs/CODE_OF_CONDUCT.md > 124 235 2013 docs/CURL-DISABLE.md > 58 342 2086 docs/PARALLEL-TRANSFERS.md > 56 378 2339 docs/VERSIONS.md > 86 399 2501 docs/DYNBUF.md > 110 528 3278 docs/RELEASE-PROCEDURE.md > 87 539 3520 docs/SSL-PROBLEMS.md > 142 383 3756 docs/HTTP3.md > 89 582 3776 docs/INSTALL.cmake > 87 676 4005 docs/HELP-US.md > 106 682 4347 docs/BUG-BOUNTY.md > 103 694 4403 docs/curl-config.1 > 135 598 4744 docs/ECH.md > 123 466 4898 docs/Makefile.am > 119 732 4942 docs/mk-ca-bundle.1 > 127 745 4945 docs/HTTP2.md > 134 812 5214 docs/HTTP-COOKIES.md > 132 849 5481 docs/SECURITY-PROCESS.md > 127 402 5544 docs/BINDINGS.md > 168 986 5903 docs/CODE_REVIEW.md > 166 994 6116 docs/CHECKSRC.md > 207 954 6153 docs/FEATURES > 167 1097 6479 docs/GOVERNANCE.md > 265 1195 7852 docs/CODE_STYLE.md > 173 1272 8346 docs/SSLCERTS.md > 246 589 10596 docs/options-in-versions > 516 722 10802 docs/CIPHERS.md > 384 1653 10997 docs/HISTORY.md > 266 2050 11950 docs/BUGS.md > 285 2027 11983 docs/MAIL-ETIQUETTE > 307 2158 13701 docs/CONTRIBUTE.md > 509 2904 20405 docs/INSTALL.md > 692 4521 28382 docs/TheArtOfHttpScripting.md > 921 3360 30208 docs/Makefile.in > 827 4564 31749 docs/KNOWN_BUGS > 2276 4900 33901 docs/THANKS > 1102 6442 43923 docs/INTERNALS.md > 1370 7345 49854 docs/TODO > 1550 10679 66585 docs/FAQ > 3369 23622 146097 docs/curl.1 > 5936 30590 200839 total docs/cmdline-opts/ > 14829 75861 577241 total docs/libcurl/ > 20219 72936 636989 total docs/examples/ > 17910 95086 640946 total docs/ > 27893 146109 1083108 total docs/libcurl/opts/ I often use Fedora as a guide when questions like this come up: https://src.fedoraproject.org/rpms/curl/blob/master/f/curl.spec Ken