Re: multi-line comments

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



1. I believe multiline text comment is one entity - which you want to
logically keep together. Line breaks in such a comment are nothing more
than places to wrap text, so breaking it up into many "separate"
comments makes no sense to me though. Therefore, I construct a single
comment block around the whole thing - using /* */.

Using /* */ makes difficulty in later use. Especially in lengthy functions and classes where there are lot of comments using /* */. For instance, if we want to comment the code and test the functionality. While // each line doesn't create this problem.

Try:

void fn1()
{
/*
  /*
   Call add
  */
  obj.add();
*/

  obj.subtract();
}


I hope you got my point.

Regards,
Jos Collin
--
To unsubscribe from this list: send the line "unsubscribe ceph-devel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html



[Index of Archives]     [CEPH Users]     [Ceph Large]     [Information on CEPH]     [Linux BTRFS]     [Linux USB Devel]     [Video for Linux]     [Linux Audio Users]     [Yosemite News]     [Linux Kernel]     [Linux SCSI]
  Powered by Linux