We have two potential solutions to this problem that don't involve appending Sleep to every example:
- Provide the expected output of the program after the code, or in well-placed comments in the code
- Provide an informal Getting Started guide, linked to from the main page, that covers issues like how to keep the program window open.
There are several methods for this, be it IDE settings, appending Sleep/Shell "pause", including a file containing a module destructor, etc. It may warrant a page of its own, linked to from the aforementioned hypothetical informal guide. As long as new people understand what is going on and how to overcome it, that's the main thing.
(Not sure what we'd call the page though..)
Inheritance documentation
-
- Site Admin
- Posts: 6323
- Joined: Jul 05, 2005 17:32
- Location: Manchester, Lancs
Re: Inheritance documentation
IMHO this is not acceptable.counting_pine wrote:It keeps the program open without hinting why.
This is my prefered solution.counting_pine wrote:- Provide the expected output of the program after the code, or in well-placed comments in the code
- The reader can check if the example meets his needs without downloading / compiling any code.
- The example author can generate the (text) output with low effort.
-
- Site Admin
- Posts: 6323
- Joined: Jul 05, 2005 17:32
- Location: Manchester, Lancs
Re: Inheritance documentation
The two methods aren't mutually exclusive though.. I think we could do with a general Getting Started guide - taking a quick look, the closest I can find is ProPgHelloWorld in the Programmer's Guide or TutGettingStartedQB in Community Tutorials. Neither are particularly obvious from the front page, and the Community Tutorials are often out of date or "unofficial", and have never really been checked through.
Re: Inheritance documentation
Added in the Glossary the definitions of:
- inheritance (TYPE or CLASS)
- object (built-in TYPE or CLASS)
- RTTI
- virtual member function
- abstract member function
- override
- polymorphism (TYPE or CLASS)
- covariance (TYPE or CLASS)
- contravariance (TYPE or CLASS)
- invariance (TYPE or CLASS)
- inheritance (TYPE or CLASS)
- object (built-in TYPE or CLASS)
- RTTI
- virtual member function
- abstract member function
- override
- polymorphism (TYPE or CLASS)
- covariance (TYPE or CLASS)
- contravariance (TYPE or CLASS)
- invariance (TYPE or CLASS)