473,325 Members | 2,480 Online
Bytes | Software Development & Data Engineering Community
Post Job

Home Posts Topics Members FAQ

Join Bytes to post your question to a community of 473,325 software developers and data experts.

FAQ topic pointers

In a recent message, "Re: Two questions about...something", Fred H wrote:
This is covered in the FAQ. Please read FAQ before posting.

I have read the FAQ, and I search it quite often. But this time
I didn't know what to search for. Now I know that I could have
searched for "initializaion", and found FAQ 10.6, but hey, I can't
read the whole FAQ through every time I have a question, can I...?


Just a thought ... how about having a sample C++ program for the FAQ that
contains pointers to relevant topics throughout the code ?

For example (assume prefix http://www.parashift.com/c++-faq-lite/ for
references):
/*** Classes and objects: classes-and-objects.html ***/

class ExampleClass // naming conventions: coding-standards.html#faq-27.11
{
// class members private by default: classes-and-objects.html#faq-7.8
int _privateMember; // naming conventions:
coding-standards.html#faq-27.11

public: // member access (public, private and protected):
basics-of-inheritance.html#faq-19.5

/*** constructors: ctors.html ***/

// default constructor: ctors.html#faq-10.4
// (see also Arrays and default constructors: ctors.html#faq-10.5)
ExampleClass();

ExampleClass(int value)
: _privateMember(value) // initialisation lists vs. assignment:
ctors.html#faq-10.6
{
// inline functions in class body: inline-functions.html#faq-9.8
}
};

It could be hard to know where to put some things, and there could be some
duplication - but this could be way to help people locate pointers into the
FAQ.

Or does something like this already exist ?

David F
Jul 22 '05 #1
6 1577
"David Fisher" <no****@nospam.nospam.nospam> wrote...
In a recent message, "Re: Two questions about...something", Fred H wrote:
This is covered in the FAQ. Please read FAQ before posting.
I have read the FAQ, and I search it quite often. But this time
I didn't know what to search for. Now I know that I could have
searched for "initializaion", and found FAQ 10.6, but hey, I can't
read the whole FAQ through every time I have a question, can I...?


Just a thought ... how about having a sample C++ program for the FAQ that
contains pointers to relevant topics throughout the code ?
[...]
It could be hard to know where to put some things, and there could be some
duplication - but this could be way to help people locate pointers into

the FAQ.


Good idea. Two doubts, though. If (rather, since) such a program does not
exist, would you write one? Once written and placed where available, how to
make sure all newbies actually look at it before posting?

V
Jul 22 '05 #2
"Victor Bazarov" <v.********@comAcast.net> wrote:
In a recent message, "Re: Two questions about...something", Fred H wrote:

Just a thought ... how about having a sample C++ program for the FAQ that
contains pointers to relevant topics throughout the code ?
[...]
It could be hard to know where to put some things, and there could be some duplication - but this could be way to help people locate pointers into
the FAQ.
Good idea. Two doubts, though. If (rather, since) such a program does

not exist, would you write one? Once written and placed where available, how to make sure all newbies actually look at it before posting?


Thanks -

I think I would by happy to do this ... depends on available time. The basic
idea might be:

- aim is to give an easily-locatable example of each kind of construct
mentioned in the FAQ
- code does not have to do something particularly useful, but should be
complete (compilable) and correct (no undefined behaviour)
- references are just to FAQ, not to other documents (the C++ standard,
etc.)
- include some examples of errors as well (syntactic or semantic) - but
just stick to the ones that are mentioned in the FAQ

I just wrote and asked Marshall Cline (owner of C++ FAQ Lite) what he
thought about this kind of thing. It's up to him, but it would be helpful to
have a pointer to the sample code on the main FAQ page (it's his document,
though ! :-)

David F
Jul 22 '05 #3
"David Fisher" <no****@nospam.nospam.nospam> wrote:
Just a thought ... how about having a sample C++ program for the FAQ that contains pointers to relevant topics throughout the code ?
[snip] I just wrote and asked Marshall Cline (owner of C++ FAQ Lite) what he
thought about this kind of thing. It's up to him, but it would be helpful to have a pointer to the sample code on the main FAQ page (it's his document,
though ! :-)


Marshall just sent a reply saying:

Very interesting idea. I suppose one could add to that all sorts of other
stuff, like operator overloading, default parameters, etc. The way I'd like
to do it would be to put links on all those things so that a user can simply
(at least when they view the stuff as HTML) simply click on a syntax-snippet
to get the corresponding subject.

Yes, please go for it. Use some simple syntax, such as <LINK:10.3> to
indicate that the preceding element should link to FAQ 10.3. Whatever
syntax you use, I'll modify it via a Perl script or something and will use
that to build the "real" solution. You can add a few things in as comments,
but as much as possible I'd prefer the hyperlink to go on the code snippet
itself - it will make the example less cluttered.

---

So I'll have a try and see how it goes ...

Code suggestions welcome,

David F
Jul 22 '05 #4
David Fisher wrote:
....

So I'll have a try and see how it goes ...

Code suggestions welcome,


Does it need to do somthing useful ?

If it does - how about using some of my (yet to be published) library ?
(That'll force me to publish the darn thing).


Jul 22 '05 #5

Gianni Mariani <gi*******@mariani.ws> wrote in message
news:bv********@dispatch.concentric.net...
David Fisher wrote:
...

So I'll have a try and see how it goes ...

Code suggestions welcome,


Does it need to do somthing useful ?

If it does - how about using some of my (yet to be published) library ?
(That'll force me to publish the darn thing).

Jul 22 '05 #6
Gianni Mariani writes:
Does it need to do somthing useful ?


No, it definitely should *not* be something useful! Teach one thing at a
time, the things you are trying to teach are syntax and semantics. Short
meaningless identifiers so no one struggles to attach some meaning to them.
Jul 22 '05 #7

This thread has been closed and replies have been disabled. Please start a new discussion.

Similar topics

6
by: john sun | last post by:
Hello, I am not newbie C++ developer infact :). But till recently I would like dig up more about C++. I know those OO details. But when people talking OO they focused on the polymorphism, and...
82
by: nobody | last post by:
Howdy, Mike! mikecoxlinux@yahoo.com (Mike Cox) wrote in message news:<3d6111f1.0402271647.c20aea3@posting.google.com>... > I'm a C++ programmer, and have to use lisp because I want to use >...
109
by: MSG | last post by:
Michel Bardiaux <michel.bardiaux@peaktime.be> wrote in message news:<G4idnfgZ0ZfCWbrdRVn2jQ@giganews.com>... > Mark Shelor wrote: > > > > > OK, Sidney, I am considering it. I can certainly...
30
by: jimjim | last post by:
Hello, This is a simple question for you all, I guess . int main(){ double *g= new double; *g = 9; delete g; cout<< sizeof(g)<<" "<<sizeof(double)<<" "<<sizeof(*g)<<" "<<*g<<" "<<endl; *g =...
115
by: junky_fellow | last post by:
What is a C object ? If i have some function "func()" in my C program, then can i say that "func()" is a C object ? or if i have some function pointer (ptr) which contains the address of...
23
by: Shalini Joshi | last post by:
Hi, I was trying to find out what exactly is meant by multi-thread safe code/functions etc. I couldn't find relevant information on the web and would appreciate any useful links/information on this...
2
by: FAQ server | last post by:
----------------------------------------------------------------------- FAQ Topic - How do I direct someone to this FAQ? ----------------------------------------------------------------------- ...
3
by: danyadler | last post by:
Hi All, The old topic: Session variables desappear. I cannot understand it! And it's driving me crazy!! So most of my aspx pages works just fine, but only 2 pages decide that after they are...
2
by: s_dubrovich | last post by:
On Oct 21, 9:58 am, Phil Carmody <thefatphil_demun...@yahoo.co.uk> wrote: I'm not changing my argument, that quote is what I replied to Rod. You are jumping into the middle of my argument, and are...
0
by: DolphinDB | last post by:
Tired of spending countless mintues downsampling your data? Look no further! In this article, you’ll learn how to efficiently downsample 6.48 billion high-frequency records to 61 million...
0
by: ryjfgjl | last post by:
ExcelToDatabase: batch import excel into database automatically...
0
by: Vimpel783 | last post by:
Hello! Guys, I found this code on the Internet, but I need to modify it a little. It works well, the problem is this: Data is sent from only one cell, in this case B5, but it is necessary that data...
0
by: jfyes | last post by:
As a hardware engineer, after seeing that CEIWEI recently released a new tool for Modbus RTU Over TCP/UDP filtering and monitoring, I actively went to its official website to take a look. It turned...
1
by: PapaRatzi | last post by:
Hello, I am teaching myself MS Access forms design and Visual Basic. I've created a table to capture a list of Top 30 singles and forms to capture new entries. The final step is a form (unbound)...
1
by: CloudSolutions | last post by:
Introduction: For many beginners and individual users, requiring a credit card and email registration may pose a barrier when starting to use cloud servers. However, some cloud server providers now...
0
by: af34tf | last post by:
Hi Guys, I have a domain whose name is BytesLimited.com, and I want to sell it. Does anyone know about platforms that allow me to list my domain in auction for free. Thank you
0
by: Faith0G | last post by:
I am starting a new it consulting business and it's been a while since I setup a new website. Is wordpress still the best web based software for hosting a 5 page website? The webpages will be...
0
isladogs
by: isladogs | last post by:
The next Access Europe User Group meeting will be on Wednesday 3 Apr 2024 starting at 18:00 UK time (6PM UTC+1) and finishing by 19:30 (7.30PM). In this session, we are pleased to welcome former...

By using Bytes.com and it's services, you agree to our Privacy Policy and Terms of Use.

To disable or enable advertisements and analytics tracking please visit the manage ads & tracking page.