Folder for executable source in projects combining lib and bin

[bvssvni]

https://github.com/carlhuda/cargo/blob/master/DESIGN/MANIFEST.md

It says bin/*.rs should contain the source code of the executable.

Normally, a bin/ folder contains the executable and the required files to run.
The content of the bin/ folder is copyable to any other folder on the same machine.
It may be target specific and only work for that machine.

Example:

1. Cloning repository.
2. ./configure
3. make
4. Copying the content of the bin/ folder.

When I see bin/ I read 'binaries' and believes it will contain the binaries required to run the application.

[bvssvni]

Alternatives:

1. Change to main/*.rs.
2. Use the module tree under src/main.rs, library as module tree under src/lib.rs.

The second solution sounds messy, but it allows one to move modules easily from executable source to library. The executable is usually a thin wrapper on top of the library. A positive side effect is that it encourages writing apps as reusable libraries.

Rust-Empty (https://github.com/bvssvni/rust-empty) uses the second alternative at the moment.

I don't have a very strong opinion about how it should be, but I am strongly against using bin/ because it is confusing.

[bvssvni]

Oh, sorry! I thought lib/ and bin/ were under the top directory.