C++: Docs & Refactoring
C++: Docs & Refactoring
- Subject: C++: Docs & Refactoring
- From: Sensei <email@hidden>
- Date: Thu, 06 Mar 2014 13:06:56 +0100
Dear all,
I have two simple questions regarding Xcode's "view" of C++. Forgive me,
but I feel that C++ is a second (third?) rate citizen in Xcode.
First question.
Has anyone ever succeeded in refactoring C++ code? Owing to LLVM &
Clang, refactoring should be working like a charm. And it's been quite a
while since the switch to clang... so why isn't refactoring available?
Second question.
Why isn't there a C++ "inline" documentation? And by inline I mean both
the Quick Help in the side bar, and the option-click on a symbol. This
is distressing, since it seems that it works perfectly with other
libraries (boost for instance), and to worsen the situation, it works
for any documented C++ code. Case in point:
//! This class rocks
class abc
{
public:
//! This is my only member variable
int q;
//! @function print
//! @param i Some integer that multiplies q
//! @param j A useless parameter
//! @brief This prints, but I was testing
//! multiline comments, and they work
void print(int i = 1, int j = 1) { std::cout << q * i << std::endl; };
It works for custom code, so why isn't the C++ headers documented as
they should? Yes, I could justify it with "hey, it's libc++ team's
business to write documentation", but I don't think it could just be
ditched as somebody's else business. Moreover, C functions are, in fact,
documented, just include something like stdlib.h and see qsort or bsearch.
Thanks & Cheers!
_______________________________________________
Do not post admin requests to the list. They will be ignored.
Xcode-users mailing list (email@hidden)
Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden