why do people here think this is impressive? dwm codebase is small, 2kloc if I remember correctly and it doesn't use anything strange or particularly obscure. you could do this in a couple of hours
besides, the dwm codebase is perfectly readable, if you can understand the few bits of actually useful information in those comments, you can understand the code without the comments
>explaining what some obscure Xlib function does for people who've never done X11 programming is the same as writing redundant comments about integer operations
>XSetLineAttributes >obscure
you should explain the integer operations for the people who've never done math
>documenting things bad
Sorry if you have assburgers but this is common outside of group of individuals incapable of passing their genes. However if would be better if this guy documented actually useful software so I too wonder why even bother.
This computational operation increments the value of the
integer variable "i" by the standard integer unit value (one) (1).
The operation may overflow the bits comprising i, causing
the value to wrap around around to the most negative value
representable by the integer type. On 32-bit Windows targets
(make TARGET=win32), care should be taken not to exceed...
*/
>explaining what some obscure Xlib function does for people who've never done X11 programming is the same as writing redundant comments about integer operations
Reinventing the wheel. Just leave a comment the says something like
Bittorrent or IPFS URI to the best explanation such that when I right-click on acme it opens the file, be it text or pdf or ps or djvu etc.
>NOOOO you can't just write comments explaining how Xlib works, people are supposed to learn it from the ancient, incomplete documentation just like I did #NoPainNoGain
Reverse searching the link in the op, of course.
which give https://www.reddit.com/user/bakkeby
who owns the repo and the aforementioned Subreddit
I have reddit set to loopback in my /etc/hosts
STFU you man with homosexual tendencies, if he went through all that effort, he should have just used cweb with troff or something and made something actually readable.
how can anyone look at this and think "yeah, this is the correct way of developing software"
2 years ago
Anonymous
It's better if the *roff or *TeX is used instead of Markdown, also unlike here the programmer should be literate in English and writing.
2 years ago
Anonymous
Why?
2 years ago
Anonymous
They simply look better, *roff is just as easy as markdown and can output straight text if you want (man pages) or book tier pdfs.
The programmer should be literate in English, as it is lingua franca, and they should be literate writers, so people can easily grok the meaning behind their words.
Bloat
Kek, you aren't kidding, there are multiple lines for every line of code.
Kinda based but also a bit overdone.
It's good for people who don't know C but want to customize it
It's also good for people who know some C but have no experience in X11 programming.
It’s actually super based, if you ever need to look at or modify the DWM code you basically have an entire enclyopedia for every single line
There’s so many code bases I wish had this kind of reference
Thats what documentation is for... hello? You dont pollute your codebase with comments for several reasons. Jr mentality.
documentation is never well written
yeah but suckmore people are p moronic and want you to just page through the source files till it makes sense.
1/3 is auto-generated, 1/3 is useless gibberish like
and the remaining 1/3 is either irrelevant or meaningless (
)
to farm github stars and "relevancy" I guess
why do people here think this is impressive? dwm codebase is small, 2kloc if I remember correctly and it doesn't use anything strange or particularly obscure. you could do this in a couple of hours
besides, the dwm codebase is perfectly readable, if you can understand the few bits of actually useful information in those comments, you can understand the code without the comments
>XSetLineAttributes
>obscure
you should explain the integer operations for the people who've never done math
Never write comments for people that don't even know the language.
>/* Allocate memory to hold the new monitor. */
>m = ecalloc(1, sizeof(Monitor));
>nooo you cant teach people, mub sekrit klub, read the heckin sicperino
Seethe while I acquire new knowledge and skills. lol. lmao, even.
Cope and seethe your troon moron.
Goon yourself to sissy hypno while Black folk rail your women.
>Goon yourself to sissy hypno while Black folk rail your women.
Yes sir.
waiting for the brodie video before i have an opinion on this tbh
>some madlad
i.e. you?
It's by the creator of flexipatch.
this is excellent, I've been using dwm for 2 years and honestly have no idea what happens in it outside my config.h
based autism. looks great for starting learning x11
>making very readable code unreadable
why?
>documenting things bad
Sorry if you have assburgers but this is common outside of group of individuals incapable of passing their genes. However if would be better if this guy documented actually useful software so I too wonder why even bother.
/*
Add 1 to i.
This computational operation increments the value of the
integer variable "i" by the standard integer unit value (one) (1).
The operation may overflow the bits comprising i, causing
the value to wrap around around to the most negative value
representable by the integer type. On 32-bit Windows targets
(make TARGET=win32), care should be taken not to exceed...
*/
etc.
There's no such thing in
https://github.com/bakkeby/dwm-commented/blob/master/drw.c#L160
>explaining what some obscure Xlib function does for people who've never done X11 programming is the same as writing redundant comments about integer operations
Reinventing the wheel. Just leave a comment the says something like
Bittorrent or IPFS URI to the best explanation such that when I right-click on acme it opens the file, be it text or pdf or ps or djvu etc.
>NOOOO you can't just write comments explaining how Xlib works, people are supposed to learn it from the ancient, incomplete documentation just like I did #NoPainNoGain
You saw this on Reddit.com specifically r/unixporn didn't you, you homosexual.
Well, anon, I'm not him but how would you know?
Reverse searching the link in the op, of course.
which give https://www.reddit.com/user/bakkeby
who owns the repo and the aforementioned Subreddit
I have reddit set to loopback in my /etc/hosts
commenting code at all is so reddit
Autism is one hell of a drug.
Imagine seething about comments in an educational project that's only meant to be used as reference material.
STFU you man with homosexual tendencies, if he went through all that effort, he should have just used cweb with troff or something and made something actually readable.
Responding to myself
https://github.com/driusan/dewm/
how can anyone look at this and think "yeah, this is the correct way of developing software"
It's better if the *roff or *TeX is used instead of Markdown, also unlike here the programmer should be literate in English and writing.
Why?
They simply look better, *roff is just as easy as markdown and can output straight text if you want (man pages) or book tier pdfs.
The programmer should be literate in English, as it is lingua franca, and they should be literate writers, so people can easily grok the meaning behind their words.