Wiki FAQ

dwks · 12-21-2007, 06:54 PM

It doesn't seem to be configured properly. From here, I get:

Code:

Warning: main(includes/SiteConfiguration.php): failed to open stream: No such file or directory in\
/home/groups/c/cb/cboardwiki/htdocs/mediawiki-1.6.10/includes/DefaultSettings.php on line 31

Fatal error: main(): Failed opening required 'includes/SiteConfiguration.php' (include_path='.:/usr/local/share/pear') in\
/home/groups/c/cb/cboardwiki/htdocs/mediawiki-1.6.10/includes/DefaultSettings.php on line 31

[edit] I'm off -- see you Friday. I expect this will be up and running by then, right?

[/edit]

zacs7 · 12-21-2007, 07:18 PM

That's because I was still uploading it

zacs7 · 12-21-2007, 07:51 PM

Well it's done, but I'll wait for the name change before I do anything more. Also should the wiki be collapsed from ./wiki to . ? So it's http://cpwiki.sf.net/void_main for example.

Elysia · 12-21-2007, 08:25 PM

Sure, that sounds good.

Daved · 12-23-2007, 12:19 PM

Did you guys send a PM to webmaster? He might like the idea and want to make it an official addition to the site (I would if I was him and had time). The problem might be that you guys wouldn't be able to administer the wiki, but if he has time to set it up and get it started I think that would be preferred. I don't think that will actually happen but you might want to ask just in case.

>> Who are we targetting this site for? Is it going to aim at the void-mainers or the more confuzzled variety?

I think there is a need for a community edited and reviewed FAQ that is based off the questions that are frequently asked on this site. Existing FAQs are quite good (like C++ FAQ Lite), but they don't necessarily cover the questions that are frequently answered here. I think this should be the initial focus of the project (or at least would be my initial focus for making contributions).

I think such a project would be beneficial to this board, as it would enhance the quality of answers that can be provided quickly.

Separate from that, tutorials on basic C or C++, as well as tutorials on more specific topics might be nice. The fact that they would (ideally) be edited and reviewed by members of this site is nice. But still I think the target audience should be the people that come to the cboard and ask questions. The strength of this site is the help for beginners, and I think a wiki should target that same crowd.

dwks · 12-23-2007, 01:30 PM

Since no one seems to have sent a PM to the webmaster, I just did. (To webmaster, kermi3, and Salem, to be exact.)

(Yes, I managed to get online a day ahead of schedule.)

Elysia · 12-23-2007, 01:50 PM

I was thinking a simple app to catch beginner mistakes too.
It doesn't need to be a code analyzer - there are professional ones out there, costing a lot of money. But just a small parser to catch simply mistakes such an indentation problem, scanf("%s", ...), void main and so on.

dwks · 12-23-2007, 02:15 PM

Detecting "bad" indentation would be a lot more difficult than it sounds. Consider that all of these

Code:

if(x) {
    code();
}
if(x)
{
    code();
}
if (x)
  {
    code();
  }
if ( x )
    {
    code();
    }

might make acceptable indentation styles, but mixing them would probably be considered bad practice. So such a program would have to keep track of what indentation style is being used, and make sure the program sticks with it.

Assuming you had envisioned something that sophisticated. You could just count the spaces at the beginning of a line and make sure the counts are all multiples of some number like 2 or 4.

Having said that, such a program would be rather interesting -- you could even make it say things like "void main() is non-standard -- you should use int main() instead: <link to faq>" when it detected void main()!

You could make it into a bot which crawled CBoard, scolding everyone for using void main()! . . . and call it PedanticAutomatedBeginnerBlunderDetector.

Elysia · 12-23-2007, 02:18 PM

I'm writing the parser right now. It's not as difficult as it sounds. Functions are a little more difficult, however, due to variable types.
I'm going to program it to recognize standard types, since I don't want to make it parse and crawl through headers, as well.

**laserlight** · 12-23-2007, 02:23 PM

Quote:

Having said that, such a program would be rather interesting -- you could even make it say things like "void main() is non-standard -- you should use int main() instead: <link to faq>" when it detected void main()!

hmm... but this can get tricky with C++ since it is perfectly acceptable for a main function in a namespace or class scope to have a return type of void. Then again, it is also acceptable to use non-standard code if the situation requires it.

Elysia · 12-23-2007, 02:33 PM

I'm not looking into making it too advanced, of course, so let's just make it complain at all void main until further notice.
Of course, since this is a dev community, anyone who want to see the source or join can do so.

**laserlight** · 12-23-2007, 02:55 PM

Quote:

Also should the wiki be collapsed from ./wiki to . ? So it's http://cpwiki.sf.net/void_main for example.

If this is done properly I would suggest that this forum include a wiki bbcode tag. Over at phpbuilder.com forums we have a man bbcode tag that links to php.net (the PHP manual, actually), and this has proven extremely useful.

dwks · 12-23-2007, 03:04 PM

I'd like to see the source code. C++, right?

As a suggestion, why don't you use an already-existing parser? Something like Elsa might be overkill, but you can download Lex+YACC specifications for C++.

It might not be worth it, especially if you've never used those tools before, but it would probably be less error-prone.

Elysia · 12-23-2007, 03:08 PM

I'll zip it up and post it (once I get rid of all compile errors, that is). I was right in the middle of redesigning the interface when finding out it didn't work with the old one.
I haven't actually used another parser before, but work is proceeding smoothly.
Since I use Visual Studio 2008 to compile, there may be some problems. I won't actually change any of the project settings and such - I'll keep it so that it compiles on my machine. It shouldn't be hard to change the settings and link to the library properly to use it.

I'll post UNICODE version.

Elysia · 12-23-2007, 04:04 PM

I believe I have everything ready.
http://www.eluni.net/temp
There are two files there, both are for the project.
In case you don't have/use Visual Studio 2008, I have the runtime (required for the DLL!) here:
http://www.eluni.net/downloads/VS2008 Runtime

So what needs to be done to compile? Link against the library using the included .lib.
Fix up the includes so the library headers are included properly.
Remember that the library is built with unicode, so unless the project is built with unicode, you'll get linking errors.

Have fun

12-21-2007, 06:54 PM	#61
dwks Frequently Quite Prolix Join Date: Apr 2005 Location: Canada Posts: 7,698	It doesn't seem to be configured properly. From here, I get: Code: Warning: main(includes/SiteConfiguration.php): failed to open stream: No such file or directory in\ /home/groups/c/cb/cboardwiki/htdocs/mediawiki-1.6.10/includes/DefaultSettings.php on line 31 Fatal error: main(): Failed opening required 'includes/SiteConfiguration.php' (include_path='.:/usr/local/share/pear') in\ /home/groups/c/cb/cboardwiki/htdocs/mediawiki-1.6.10/includes/DefaultSettings.php on line 31 [edit] I'm off -- see you Friday. I expect this will be up and running by then, right? [/edit] __________________ dwk Seek and ye shall find. quaere et invenies. "Simplicity does not precede complexity, but follows it." -- Alan Perlis "Testing can only prove the presence of bugs, not their absence." -- Edsger Dijkstra "The only real mistake is the one from which we learn nothing." -- John Powell Other boards: DaniWeb, TPS Unofficial Wiki FAQ: cpwiki.sf.net My website: http://dwks.theprogrammingsite.com/ Projects: codeform, xuni, atlantis, nort, etc. Last edited by dwks; 12-21-2007 at 07:01 PM.
dwks is offline

12-21-2007, 07:18 PM	#62
zacs7 Woof, woof! Join Date: Mar 2007 Location: Australia Posts: 3,295	That's because I was still uploading it __________________ "I.T. gets the chicky-babes" - M. Kelly bakefile \| vim
zacs7 is offline

12-21-2007, 07:51 PM	#63
zacs7 Woof, woof! Join Date: Mar 2007 Location: Australia Posts: 3,295	Well it's done, but I'll wait for the name change before I do anything more. Also should the wiki be collapsed from ./wiki to . ? So it's http://cpwiki.sf.net/void_main for example. __________________ "I.T. gets the chicky-babes" - M. Kelly bakefile \| vim
zacs7 is offline

12-23-2007, 12:19 PM	#65
Daved Registered User Join Date: Jan 2005 Posts: 7,252	Did you guys send a PM to webmaster? He might like the idea and want to make it an official addition to the site (I would if I was him and had time). The problem might be that you guys wouldn't be able to administer the wiki, but if he has time to set it up and get it started I think that would be preferred. I don't think that will actually happen but you might want to ask just in case. >> Who are we targetting this site for? Is it going to aim at the void-mainers or the more confuzzled variety? I think there is a need for a community edited and reviewed FAQ that is based off the questions that are frequently asked on this site. Existing FAQs are quite good (like C++ FAQ Lite), but they don't necessarily cover the questions that are frequently answered here. I think this should be the initial focus of the project (or at least would be my initial focus for making contributions). I think such a project would be beneficial to this board, as it would enhance the quality of answers that can be provided quickly. Separate from that, tutorials on basic C or C++, as well as tutorials on more specific topics might be nice. The fact that they would (ideally) be edited and reviewed by members of this site is nice. But still I think the target audience should be the people that come to the cboard and ask questions. The strength of this site is the help for beginners, and I think a wiki should target that same crowd.
Daved is offline

12-23-2007, 01:30 PM	#66
dwks Frequently Quite Prolix Join Date: Apr 2005 Location: Canada Posts: 7,698	Since no one seems to have sent a PM to the webmaster, I just did. (To webmaster, kermi3, and Salem, to be exact.) (Yes, I managed to get online a day ahead of schedule.) __________________ dwk Seek and ye shall find. quaere et invenies. "Simplicity does not precede complexity, but follows it." -- Alan Perlis "Testing can only prove the presence of bugs, not their absence." -- Edsger Dijkstra "The only real mistake is the one from which we learn nothing." -- John Powell Other boards: DaniWeb, TPS Unofficial Wiki FAQ: cpwiki.sf.net My website: http://dwks.theprogrammingsite.com/ Projects: codeform, xuni, atlantis, nort, etc.
dwks is offline

12-23-2007, 02:15 PM	#68
dwks Frequently Quite Prolix Join Date: Apr 2005 Location: Canada Posts: 7,698	Detecting "bad" indentation would be a lot more difficult than it sounds. Consider that all of these Code: if(x) { code(); } if(x) { code(); } if (x) { code(); } if ( x ) { code(); } might make acceptable indentation styles, but mixing them would probably be considered bad practice. So such a program would have to keep track of what indentation style is being used, and make sure the program sticks with it. Assuming you had envisioned something that sophisticated. You could just count the spaces at the beginning of a line and make sure the counts are all multiples of some number like 2 or 4. Having said that, such a program would be rather interesting -- you could even make it say things like "void main() is non-standard -- you should use int main() instead: <link to faq>" when it detected void main()! You could make it into a bot which crawled CBoard, scolding everyone for using void main()! . . . and call it PedanticAutomatedBeginnerBlunderDetector. __________________ dwk Seek and ye shall find. quaere et invenies. "Simplicity does not precede complexity, but follows it." -- Alan Perlis "Testing can only prove the presence of bugs, not their absence." -- Edsger Dijkstra "The only real mistake is the one from which we learn nothing." -- John Powell Other boards: DaniWeb, TPS Unofficial Wiki FAQ: cpwiki.sf.net My website: http://dwks.theprogrammingsite.com/ Projects: codeform, xuni, atlantis, nort, etc.
dwks is offline

12-23-2007, 03:04 PM	#73
dwks Frequently Quite Prolix Join Date: Apr 2005 Location: Canada Posts: 7,698	I'd like to see the source code. C++, right? As a suggestion, why don't you use an already-existing parser? Something like Elsa might be overkill, but you can download Lex+YACC specifications for C++. It might not be worth it, especially if you've never used those tools before, but it would probably be less error-prone. __________________ dwk Seek and ye shall find. quaere et invenies. "Simplicity does not precede complexity, but follows it." -- Alan Perlis "Testing can only prove the presence of bugs, not their absence." -- Edsger Dijkstra "The only real mistake is the one from which we learn nothing." -- John Powell Other boards: DaniWeb, TPS Unofficial Wiki FAQ: cpwiki.sf.net My website: http://dwks.theprogrammingsite.com/ Projects: codeform, xuni, atlantis, nort, etc.
dwks is offline

Thread Tools
Show Printable Version Email this Page
Display Modes
Linear Mode Switch to Hybrid Mode Switch to Threaded Mode

Similar Threads
Thread	Thread Starter	Forum	Replies	Last Post
Wiki FAQ	Queatrix	General Discussions	6	03-25-2007 03:39 AM
Wiki for Tutorials	jverkoey	General Discussions	7	08-16-2005 03:03 PM
FAQ Check/Lock	RoD	A Brief History of Cprogramming.com	2	10-15-2002 11:21 AM