module CreatePairs
    export create_pair
    export (scoped-true), cp

    """
        create_pair(x)

    creates the pair `x => x`
    """
    create_pair(x) = _create_pair(x)

    """
        cp(x)

    creates the pair `x => x`
    """
    cp(x) = _create_pair(x)

    """
        _create_pair(x)

    creates the pair `x => x`
    """
    _create_pair(x) = x => x
end

julia> using .CreatePairs

julia> names(CreatePairs)
3-element Vector{Symbol}:
 :CreatePairs
 :cp
 :create_pair

julia> names(CreatePairs, scoped=false)
2-element Vector{Symbol}:
 :CreatePairs
 :create_pair

julia> create_pair(1)
1 => 1

julia> cp(1)
ERROR: MethodError: no method matching cp(::Int64)

Closest candidates are:
  cp(::AbstractString, ::AbstractString; force, follow_symlinks)
   @ Base file.jl:376

Stacktrace:
 [1] top-level scope
   @ REPL[7]:1

julia> CreatePairs.cp(1)
1 => 1

julia> _create_pair(1)
ERROR: UndefVarError: `_create_pair` not defined
Stacktrace:
 [1] top-level scope
   @ REPL[9]:1

julia> CreatePairs._create_pair(1)
1 => 1

help?> create_pair
search: create_pair

  create_pair(x)

  creates the pair x => x

help?> CreatePairs.cp
  cp(x)

  creates the pair x => x

help?> CreatePairs._create_pair
  _create_pair(x)

  creates the pair x => x

…cstrings

module CreatePairs
    export create_pair
    export (scoped-true), cp

    """
        create_pair(x)

    creates the pair `x => x`
    """
    create_pair(x) = _create_pair(x)

    """
        cp(x)

    creates the pair `x => x`
    """
    cp(x) = _create_pair(x)

    """
        _create_pair(x)

    creates the pair `x => x`
    """
    _create_pair(x) = x => x
end

julia> using .CreatePairs

julia> names(CreatePairs)
3-element Vector{Symbol}:
 :CreatePairs
 :cp
 :create_pair

julia> names(CreatePairs, scoped=false)
2-element Vector{Symbol}:
 :CreatePairs
 :create_pair

julia> create_pair(1)
1 => 1

julia> cp(1)
ERROR: MethodError: no method matching cp(::Int64)

Closest candidates are:
  cp(::AbstractString, ::AbstractString; force, follow_symlinks)
   @ Base file.jl:376

Stacktrace:
 [1] top-level scope
   @ REPL[6]:1

julia> CreatePairs.cp(1)
1 => 1

julia> _create_pair(1)
ERROR: UndefVarError: `_create_pair` not defined
Stacktrace:
 [1] top-level scope
   @ REPL[8]:1

julia> CreatePairs._create_pair(1)
1 => 1

help?> create_pair
search: create_pair

  create_pair(x)

  creates the pair x => x

help?> CreatePairs.cp
  cp(x)

  creates the pair x => x

help?> CreatePairs._create_pair
  INTERNAL

  ────────────────────────────────────────────────────────────────────

  _create_pair(x)

  creates the pair x => x

…: trim for concision and clarity)

…ls for `dev`ed packages and Base if built from source)

…versial)

…ublic

because it is not idiomatic to mark symbols in Main as public. Helps with repl completions and docstrings.

needs tests.

mostly, this was fixing the test files to either make demo bindings public or expect internal warnings when they are not
additionally, fix internal warning for non-markdown content (give up instead of erroring)

…e they are adequitely covered in base/test/docs.jl

From @gbaraldi

Co-authored-by: Jameson Nash <[email protected]>

Co-authored-by: Claire Foster <[email protected]>

Co-authored-by: Claire Foster <[email protected]>

…blic) and publicize `isexported` and `ispublic`

How to get the old behavior? `filter(isexported, names(args...; kw...)`

The set of possible keywods and interacitons is huge and it is better to give folks composable functions than a giant, tangled keyword system that is bound to be eternaly cludgey to maintain backwards compatability.

Documents but does not publicize `isdeprecated` and `isbindingresolved`.

…rectly

Co-authored-by: Gerhard Aigner <[email protected]>