From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp-out-no.shaw.ca (smtp-out-no.shaw.ca [64.59.134.12]) by sourceware.org (Postfix) with ESMTPS id 4A0493857819 for ; Sat, 17 Oct 2020 21:38:50 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 4A0493857819 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=SystematicSw.ab.ca Authentication-Results: sourceware.org; spf=none smtp.mailfrom=brian.inglis@systematicsw.ab.ca Received: from [192.168.1.104] ([24.64.172.44]) by shaw.ca with ESMTP id TtuaktWtqtdldTtubk5MQx; Sat, 17 Oct 2020 15:38:49 -0600 X-Authority-Analysis: v=2.4 cv=INe8tijG c=1 sm=1 tr=0 ts=5f8b6469 a=kiZT5GMN3KAWqtYcXc+/4Q==:117 a=kiZT5GMN3KAWqtYcXc+/4Q==:17 a=IkcTkHD0fZMA:10 a=ejknC5xS72zp2OFXFO8A:9 a=QEXdDO2ut3YA:10 a=f08ICETBwzYA:10 Reply-To: cygwin-apps@cygwin.com To: cygwin-apps@cygwin.com From: Brian Inglis Subject: curl new version docs advice and opinions requested Autocrypt: addr=Brian.Inglis@SystematicSw.ab.ca; prefer-encrypt=mutual; keydata= mDMEXopx8xYJKwYBBAHaRw8BAQdAnCK0qv/xwUCCZQoA9BHRYpstERrspfT0NkUWQVuoePa0 LkJyaWFuIEluZ2xpcyA8QnJpYW4uSW5nbGlzQFN5c3RlbWF0aWNTdy5hYi5jYT6IlgQTFggA PhYhBMM5/lbU970GBS2bZB62lxu92I8YBQJeinHzAhsDBQkJZgGABQsJCAcCBhUKCQgLAgQW AgMBAh4BAheAAAoJEB62lxu92I8Y0ioBAI8xrggNxziAVmr+Xm6nnyjoujMqWcq3oEhlYGAO WacZAQDFtdDx2koSVSoOmfaOyRTbIWSf9/Cjai29060fsmdsDLg4BF6KcfMSCisGAQQBl1UB BQEBB0Awv8kHI2PaEgViDqzbnoe8B9KMHoBZLS92HdC7ZPh8HQMBCAeIfgQYFggAJhYhBMM5 /lbU970GBS2bZB62lxu92I8YBQJeinHzAhsMBQkJZgGAAAoJEB62lxu92I8YZwUBAJw/74rF IyaSsGI7ewCdCy88Lce/kdwX7zGwid+f8NZ3AQC/ezTFFi5obXnyMxZJN464nPXiggtT9gN5 RSyTY8X+AQ== Organization: Systematic Software Message-ID: <92223869-af86-ff0d-c2a3-7747814f8dfd@SystematicSw.ab.ca> Date: Sat, 17 Oct 2020 15:38:48 -0600 User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:68.0) Gecko/20100101 Thunderbird/68.12.1 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Language: en-CA Content-Transfer-Encoding: 7bit X-CMAE-Envelope: MS4xfFkPaJhp9XkvbHwVqzr5k48O6GHdTOixebifgNKSR6P9OQ1e3vdkxkVsv89p4wFOxoEWKGOo8U1qgDrc0hnw+2y2eK8W8RQLSHP1V+ECWu1rzgUhNnqu p0uBYqHEC0PgvkF6Mk8zyrA0I00n8xKN8JBdhzae9MN+bimfGOhn5/gCQzm53Z7J4NV4D4gP7UQfAYCGNZTQsq8Ivj90fIiPKf0= X-Spam-Status: No, score=-6.5 required=5.0 tests=BAYES_00, KAM_DMARC_STATUS, KAM_LAZY_DOMAIN_SECURITY, RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL, SPF_HELO_NONE, SPF_NONE, TXREP autolearn=no 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 21:38:52 -0000 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/ -- Take care. Thanks, Brian Inglis, Calgary, Alberta, Canada This email may be disturbing to some readers as it contains too much technical detail. Reader discretion is advised. [Data in binary units and prefixes, physical quantities in SI.]