Feedback for documentation of C++ open source library

Oct 7, 2016 at 9:57pm
Hi, we would appreciate any feedback about the documentation of this C++ open source library:

Intropy compile-time library
Description

This high performance compile-time library is useful to get entropy from stdin.

This alternative for all random number generators, enables the user to choose at run-time any file, stream or keyboard as source of entropy.
Use
1
2
3
4
5
#include<ncomputers/Intropy.hpp>
#define BlockSize 512 //optional
using namespace ncomputers;
Intropy<unsigned,BlockSize>rand;
unsigned num=rand();

1
2
3
4
5
#!/bin/bash
random | binary
binary < /dev/random
binary < /dev/null
binary < file

Install
1
2
#ncomputers.org/debian
apt-get install intropy

Compile

g++ -O3 -std=c++11 source.cpp -o binary

http://ncomputers.org/intropy
Last edited on Oct 7, 2016 at 10:07pm
Oct 8, 2016 at 12:54am
What is this library for?
What would we possibly benefit from it?

This alternative for all random number generators, enables the user to choose at run-time any file, stream or keyboard as source of entropy.

+ Sounds a little bit disappointing. You are still using rand().
+ CPlusPlus now have an even better standard random library (#include <random> )
+ It takes too many steps to set up your library and compile it. What a pain.
Oct 8, 2016 at 1:11am
Hi, thank you very much for your feedback! Kind regards,

What is this library for?

To get random numbers (entropy) from stdin.

What would we possibly benefit from it?

The user is able to choose which source of entropy (random numbers) to use at run-time.

+ Sounds a little bit disappointing. You are still using rand().

This library only uses the c standrad input output library #include<cstdio>

+ CPlusPlus now have an even better standard random library (#include <random> )

It is a set of pseudo-random number geneartors, which without seed output 0 ubits/1 bits plus an interface to a hardware random number generator if available. Please note that there are possibilities of generating true random numbers without a special device, and those methods are not included inside the library #include<random>

+ It takes too much steps to set up your library and compile it. What a pain.

1) Download it.
2) Write the four lines below:
1
2
3
4
#include"Intropy.hpp"
using namespace ncomputers;
Intropy<unsigned,BlockSize>rand;
unsigned num=rand();
Last edited on Oct 8, 2016 at 1:41am
Topic archived. No new replies allowed.