Skip to content

Conversation

@maflcko
Copy link
Member

@maflcko maflcko commented Apr 1, 2020

This is required to host the documentation on a static resource (like a website or pdf)

@maflcko maflcko force-pushed the 2004-rpcStaticDoc branch from fa0c6c2 to fab3255 Compare April 1, 2020 16:25
@maflcko maflcko changed the title rpc: Make rpc documentation not depend on rpc args rpc: Make rpc documentation not depend on call-time rpc args Apr 1, 2020
Copy link
Contributor

@cvengler cvengler left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Concept ACK, a static documentation is most likely a better choice



static const std::string WALLET_ENDPOINT_BASE = "/wallet/";
static const std::string HELP_REQUIRING_PASSPHRASE{"\nRequires wallet passphrase to be set with walletpassphrase call if wallet is encrypted.\n"};
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: The line above is not using a C++11 list init. I would change it to a C one to keep it coherent.

Copy link
Contributor

@theStack theStack left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Concept ACK

Copy link
Contributor

@promag promag left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ACK fab3255.

@cvengler
Copy link
Contributor

cvengler commented Apr 1, 2020

utACK fab3255

@DrahtBot
Copy link
Contributor

DrahtBot commented Apr 1, 2020

The following sections might be updated with supplementary metadata relevant to reviewers and maintainers.

Conflicts

Reviewers, this pull request conflicts with the following ones:

If you consider this pull request important, please also help to review the conflicting pull requests. Ideally, start with the one that should be merged first.

@maflcko maflcko merged commit c897154 into bitcoin:master Apr 3, 2020
@maflcko maflcko deleted the 2004-rpcStaticDoc branch April 3, 2020 19:16
sidhujag pushed a commit to syscoin/syscoin that referenced this pull request Apr 8, 2020
…ime rpc args

fab3255 rpc: Make rpc documentation not depend on rpc args (MarcoFalke)

Pull request description:

  This is required to host the documentation on a static resource (like a website or pdf)

ACKs for top commit:
  emilengler:
    utACK fab3255
  promag:
    ACK fab3255.

Tree-SHA512: 3ca2691c7fbd5f17c75df2887753da152f66521dcb7dee4c29af6339fdea011cecdd51f825b96bde9c6aaf82f4d915cbd5aacb52e4eae3898d9dbc216f627171
maflcko pushed a commit to maflcko/bitcoin-core that referenced this pull request Apr 10, 2020
… depend on global args

fad691c rpc: Make verifychain default values static, not depend on global args (MarcoFalke)

Pull request description:

  This fixes several issues:

  * The documentation is not compile-time static and depends on run-time arguments, making it impossible to host it on a static resource like a website or pdf. See also a similar change in the wallet rpc code: bitcoin#18499
  * The same call (relying on default values) will run different code on different machines, depending on the command line args that were used to start the server. This might lead to hard-to-debug-remote issues.

  This is a small behaviour change, and I will add release notes.

ACKs for top commit:
  theStack:
    ACK bitcoin@fad691c
  promag:
    Code review ACK fad691c.

Tree-SHA512: 1c7a253ff0ec13a973b10d3777b71c70954ded5805b65a3ab06317327014de4cd0601d71d30c6ce89a581722c150cb5567acc1bd3e0c789cb51bab6ef0dcfc4a
sidhujag pushed a commit to syscoin/syscoin that referenced this pull request Apr 13, 2020
… depend on global args

fad691c rpc: Make verifychain default values static, not depend on global args (MarcoFalke)

Pull request description:

  This fixes several issues:

  * The documentation is not compile-time static and depends on run-time arguments, making it impossible to host it on a static resource like a website or pdf. See also a similar change in the wallet rpc code: bitcoin#18499
  * The same call (relying on default values) will run different code on different machines, depending on the command line args that were used to start the server. This might lead to hard-to-debug-remote issues.

  This is a small behaviour change, and I will add release notes.

ACKs for top commit:
  theStack:
    ACK bitcoin@fad691c
  promag:
    Code review ACK fad691c.

Tree-SHA512: 1c7a253ff0ec13a973b10d3777b71c70954ded5805b65a3ab06317327014de4cd0601d71d30c6ce89a581722c150cb5567acc1bd3e0c789cb51bab6ef0dcfc4a
deadalnix pushed a commit to Bitcoin-ABC/bitcoin-abc that referenced this pull request Jan 14, 2021
Summary:
> This is required to host the documentation on a static resource (like a website or pdf)

Thisis a backport of Core [[bitcoin/bitcoin#18499 | PR18499]]

Test Plan:
Display the help message of one of the affected commands:

```
for COMMAND in sendtoaddress signmessage sendmany keypoolrefill signrawtransactionwithwallet sethdseed walletprocesspsbt
do
    src/bitcoin-cli help $COMMAND
done
```

Reviewers: #bitcoin_abc, majcosta

Reviewed By: #bitcoin_abc, majcosta

Differential Revision: https://reviews.bitcoinabc.org/D8902
@bitcoin bitcoin locked as resolved and limited conversation to collaborators Feb 15, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants