code: def test_alter_interface_docs_for_cmdline():
      alt = alter_interface_docs_for_cmdline(demo_doc)
      alt_l = alt.split("\n")
      # de-dented
      assert_false(alt_l[0].startswith(" "))
      assert_false(alt_l[-1].startswith(" "))
      assert_not_in("PY", alt)
      assert_not_in("CMD", alt)
      assert_not_in("REFLOW", alt)
      assert_in("a b", alt)
      assert_in("not\n   reflowed", alt)
      assert_in("Something for the cmdline only Multiline!", alt)
      assert_not_in("Some Python-only bits", alt)
      assert_not_in("just for Python", alt)
      assert_in("just for the command line", alt)
      assert_in("multiline cli-only with [ brackets\n[] ]", alt)
      assert_not_in("multiline\npython-only with [ brackets [] ]", alt)
  
      # args
      altarg = alter_interface_docs_for_cmdline(demo_argdoc)
      # RST role markup
      eq_(
          alter_interface_docs_for_cmdline(
              ":murks:`me and my buddies`"
          ),
          "me and my buddies",
      )
      # spread across lines
      eq_(
          alter_interface_docs_for_cmdline(
              ":term:`Barbara\nStreisand`"
          ),
          "Barbara\nStreisand",
      )
      # multiple on one line
      eq_(
          alter_interface_docs_for_cmdline(
              ":term:`one` bla bla :term:`two` bla"
          ),
          "one bla bla two bla",
      )
  
      altpd = alter_interface_docs_for_cmdline(demo_paramdoc)
      assert_not_in("PY", altpd)
      assert_not_in("CMD", altpd)
      assert_not_in("python", altpd)
      assert_not_in("python-only with [ some brackets []", altpd)
      assert_in("in between", altpd)
      assert_in("appended", altpd)
      assert_in("cmdline", altpd)
      assert_in(
          "multiline cli-only [\n  brackets included "
          "[ can we also have || ?]",
          altpd,
      )
  
imports: from datalad.interface.tests.test_docs import demo_argdoc, demo_doc, demo_paramdoc
  from datalad.tests.utils_pytest import assert_false, assert_in, assert_not_in, eq_
  from ..interface import alter_interface_docs_for_cmdline, get_cmdline_command_name
label_desc: Use image node_id 1 for calling a global function with example usage: test_alter_interface_docs_for_cmdline() without return types