docs: convert man page sources to "curldown" format#1660
Closed
vszakats wants to merge 16 commits intolibssh2:masterfrom
Closed
docs: convert man page sources to "curldown" format#1660vszakats wants to merge 16 commits intolibssh2:masterfrom
vszakats wants to merge 16 commits intolibssh2:masterfrom
Conversation
84b5bfc to
dba656a
Compare
vszakats
added a commit
to curl/curl-for-win
that referenced
this pull request
Oct 9, 2025
libssh2/libssh2@b889b39 libssh2/libssh2#1660 Fixing: ``` + read -r d + lipo -create -output curl-8.17.0-DEV_20251009-universal-macos/dep/libssh2/docs/cd2nroff.txt ./curl-8.17.0-DEV_20251009-aarch64-macos/dep/libssh2/docs/cd2nroff.txt ./curl-8.17.0-DEV_20251009-x86_64-macos/dep/libssh2/docs/cd2nroff.txt fatal error: /Applications/Xcode_16.4.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/lipo: can't figure out the architecture type of: ./curl-8.17.0-DEV_20251009-aarch64-macos/dep/libssh2/docs/cd2nroff.txt + rm -r -f /Users/runner/work/curl-for-win/curl-for-win/.cw-gpg Error: Process completed with exit code 1. ``` https://github.com/curl/curl-for-win/actions/runs/18388441115/job/52392670105#step:3:10158
vszakats
added a commit
to curl/curl-for-win
that referenced
this pull request
Oct 9, 2025
Upstream replaced `.3` source files with `.md` "curldown" ones. Simplify the copying process and avoid the new script that was picked up by `lido`, causing the job to fail. Fixing: ``` + read -r d + lipo -create -output curl-8.17.0-DEV_20251009-universal-macos/dep/libssh2/docs/cd2nroff.txt ./curl-8.17.0-DEV_20251009-aarch64-macos/dep/libssh2/docs/cd2nroff.txt ./curl-8.17.0-DEV_20251009-x86_64-macos/dep/libssh2/docs/cd2nroff.txt fatal error: /Applications/Xcode_16.4.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/lipo: can't figure out the architecture type of: ./curl-8.17.0-DEV_20251009-aarch64-macos/dep/libssh2/docs/cd2nroff.txt + rm -r -f /Users/runner/work/curl-for-win/curl-for-win/.cw-gpg Error: Process completed with exit code 1. ``` Ref: https://github.com/curl/curl-for-win/actions/runs/18388441115/job/52392670105#step:3:10158 Ref: libssh2/libssh2@b889b39 Ref: libssh2/libssh2#1660
vszakats
added a commit
to curl/curl-for-win
that referenced
this pull request
Oct 9, 2025
Upstream replaced `.3` source files with `.md` "curldown" ones. Simplify the copying process and avoid the new script that was picked up by `lido`, causing the job to fail. Fixing: ``` + read -r d + lipo -create -output curl-8.17.0-DEV_20251009-universal-macos/dep/libssh2/docs/cd2nroff.txt ./curl-8.17.0-DEV_20251009-aarch64-macos/dep/libssh2/docs/cd2nroff.txt ./curl-8.17.0-DEV_20251009-x86_64-macos/dep/libssh2/docs/cd2nroff.txt fatal error: /Applications/Xcode_16.4.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/lipo: can't figure out the architecture type of: ./curl-8.17.0-DEV_20251009-aarch64-macos/dep/libssh2/docs/cd2nroff.txt + rm -r -f /Users/runner/work/curl-for-win/curl-for-win/.cw-gpg Error: Process completed with exit code 1. ``` Ref: https://github.com/curl/curl-for-win/actions/runs/18388441115/job/52392670105#step:3:10158 Ref: libssh2/libssh2@b889b39 Ref: libssh2/libssh2#1660
vszakats
added a commit
to curl/curl-for-win
that referenced
this pull request
Oct 10, 2025
Upstream replaced `.3` source files with `.md` "curldown" ones. Simplify the copying process and avoid the new script that was picked up by `lido`, causing the job to fail. Fixing: ``` + read -r d + lipo -create -output curl-8.17.0-DEV_20251009-universal-macos/dep/libssh2/docs/cd2nroff.txt ./curl-8.17.0-DEV_20251009-aarch64-macos/dep/libssh2/docs/cd2nroff.txt ./curl-8.17.0-DEV_20251009-x86_64-macos/dep/libssh2/docs/cd2nroff.txt fatal error: /Applications/Xcode_16.4.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/lipo: can't figure out the architecture type of: ./curl-8.17.0-DEV_20251009-aarch64-macos/dep/libssh2/docs/cd2nroff.txt + rm -r -f /Users/runner/work/curl-for-win/curl-for-win/.cw-gpg Error: Process completed with exit code 1. ``` Ref: https://github.com/curl/curl-for-win/actions/runs/18388441115/job/52392670105#step:3:10158 Ref: libssh2/libssh2@b889b39 Ref: libssh2/libssh2#1660
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
To render in Git webviews as-is, to make it easier to edit, verify,
and to sync up with curl.
.3man pages:--disable-docsLIBSSH2_BUILD_DOCS=OFF.3man pages requires Perl after this patch.mansyntaxand the shell /grep/ GNUmantool requirements with it.cd2nrofffrom curl, with edits to relax curl-specific checks.nroff2cd(from curl) to convert from.3to.md. Thenmanually fixed copyrights, inline function references and a couple
of other things.
Credits-to: Daniel Stenberg
Ref: curl/curl@eefcc1b
Ref: curl/curl#12730
Ref: libssh2/www#25 (comment)
This will need updates on the libssh2/www side. But, it also allows
to just drop the documentation from the website and use this repo
directly to read man pages in the browser. They render well by default: https://github.com/vszakats/libssh2/blob/8727af0c9666c4f66db6087deb1657dbacf63d0b/docs/libssh2_channel_read_ex.md