Purpose of module macro?

[VorpalBlade]

• There is a module macro that isn't really documented.
• It is not used when declaring a module in the book.
• It is used in at least some of the internal modules.

This leads to two questions:

• If I want to declare a custom native module with a bunch of types and functions (that is not in the root namespace, but in a proper module), do I need/want that macro?
• What if I do want to put something in the root namespace?

[udoprog]

You don't need to use the macro. It's only used to define the name and documentation for the internal modules right now, something you can do by hand with Module::item_mut.

If you want to put something in the root namespace, you use Module::new.