polkadot-sdk-docs: Use command_macro!

[kianenigma]

to have a better docify version of commands. IN other words, find all instances of #[docify::export] process:Command, and replace with https://github.com/krdln/command-macros.

[programskillforverification]

What do you think of replacing with https://github.com/rust-shell-script/rust_cmd_lib? command_macro! hasn't been maintained for a long time.

[kianenigma]

If it delivers the same outcome, then yes it indeed seems better.

[iulianbarbu]

Adding some context from my investigations around testing commands that appear in crate-level docs, so that they also look similar to what one would run in a shell: #5954 (comment).

[bennethxyz]

Taking this one ☝️

[michalkucharczyk]

Taking this one ☝️

Great! This is a good reference entry point showing how to do it:

polkadot-sdk/substrate/bin/utils/chain-spec-builder/README.docify.md

Line 33 in 4df9433

<!-- docify::embed!("tests/test.rs", cmd_create_default) -->

[ndkazu]

to have a better docify version of commands. IN other words, find all instances of #[docify::export] process:Command, and replace with https://github.com/krdln/command-macros.

Let me re-frame this to see if I correctly understand the assignment:

• Within all tests using #[docify::export], select those using process:Command, and replace the use of process:Command by command_macro!.
  Is that right?
  See the corresponding PR: polkadot-sdk-docs: Use command_macro! #6624

[ndkazu]

I would like to add that I also tried using cmd_lib instead of command_macro!, but I also get a crate related error in this case 😞

Compiling chain-spec-guide-runtime v0.0.0 (/home/kazu/Polkadot/polkadot-sdk/docs/sdk/src/reference_docs/chain_spec_runtime)
  error[E0433]: failed to resolve: could not find `unix` in `os`
    --> /home/kazu/.cargo/registry/src/index.crates.io-6f17d22bba15001f/os_pipe-1.2.1/src/unix.rs:6:14
     |
  6  | use std::os::unix::prelude::*;
     |              ^^^^ could not find `unix` in `os`
     |