Seems to me that every comment there is useful to someone who might come
along later and try to understand that piece of code, and what it's doing.
Navy wrote:
Hi,
Here is a code fragment, which comments is unnessary? I think the all the
comments should be remove because the comments should show What to do rather
than How to do?. Am I right?
/
* Unit flag definitions for un_flags.
/
#define UN_ISOPEN 0x0001 /* Device is open */
#define UN_CLOSING0x0002 /* Line is being closed */
#define UN_IMM0x0004 /* Service immediately
*/
#define UN_BUSY 0x0008 /* Some work this channel
*/
#define UN_BREAKI 0x0010 /* Input break received */
#define UN_PWAIT 0x0020 /* Printer waiting for terminal */
#define UN_TIME 0x0040 /* Waiting on time
*/
#define UN_EMPTY 0x0080 /* Waiting output queue empty */
#define UN_LOW0x0100 /* Waiting output low water
mark*/
#define UN_EXCL_OPEN 0x0200 /* Open for exclusive use */
#define UN_WOPEN 0x0400 /* Device waiting for open */
#define UN_WIOCTL 0x0800 /* Device waiting for open */
#define UN_HANGUP 0x8000 /* Carrier lost */
struct device;
/
* Structure for terminal or printer unit.
/
struct un_t {
int magic; /* Unit Magic Number. */
struct channel_t *un_ch;
ulong un_time;
uintun_type;
uintun_open_count; /* Counter of opens to port */
struct tty_struct *un_tty;/* Pointer to unit tty structure */
uintun_flags; /* Unit flags */
wait_queue_head_t un_flags_wait; /* Place to sleep to wait on unit */
uintun_dev; /* Minor device number */
struct device *un_sysfs;
};
___
Kernelnewbies mailing list
Kernelnewbies@kernelnewbies.org
http://lists.kernelnewbies.org/mailman/listinfo/kernelnewbies
--
In theory, there is no difference between theory and practice.
In practice, there is. Yogi Berra
___
Kernelnewbies mailing list
Kernelnewbies@kernelnewbies.org
http://lists.kernelnewbies.org/mailman/listinfo/kernelnewbies