¿Cuáles son algunos de los comentarios más divertidos en el código fuente?

Mi comentario personal favorito viene con un código específico para admitir un procesador DEC Alpha en un sistema operativo integrado en el que trabajé.

Aunque no hay soporte para las plataformas Alpha y todo el código de las plataformas se eliminó del código base, este bloque de código escrito por un ingeniero de NetApp primigenio primigenio se conservó únicamente por razones culturales, gracias a este comentario. (Gracias especiales a la persona que recirculó esta joya de comentario a las personas que no trabajan allí).

El comentario que se escribió cuando DEC no proporcionó suficiente documentación de algún comportamiento sutil de las plataformas Alpha que hizo que portar el sistema operativo a las cajas Alpha fuera bastante doloroso.

Lo que lo hizo realmente divertido fue que el comentario resultó ser una especie de profecía, la mejor parte del comentario fue cuando alguien actualizó el comentario muchos años después, reconociendo que la profecía se había cumplido.

También generó el eslogan de uso común en ese trabajo que fue “Lo amargo es para los débiles”.

/* * On the other hand, we never get another interrupt after * the first timer interrupt, so maybe we *do* have to thwack * the stupid ICU. * * Or maybe we have to reset the stupid "interrupt latch", but * that fucking GENIUS Todd Dutton, although he took the fucking * trouble to say that you have to reset the interrupt latch, * didn't take the fucking trouble to tell you WHAT THE FUCK * THE INTERRUPT LATCH IN QUESTION IS or HOW THE FUCK YOU RESET * IT, so if that's the problem, we'll have to wait for all the * 5000 FUCKING VICE PRESIDENTS AT DEC who have to sign off on * the FUCKING IDEA OF ACTUALLY LETTING SOMEBODY WHO WANTS TO * BUY LOTS OF YOUR FUCKING BOXES TO RUN THEIR SOFTWARE ON * actually GET THEIR HANDS ON ENOUGH FUCKING DOCUMENTATION * TO MAKE THEIR SOFTWARE WORK. GOD FUCKING FORBID that DEC * actually SELL any of these boxes, that might mean they might * CONTINUE TO MAKE MONEY, and we couldn't let THAT happen, * COULD we? * * No, I'm not bitter. Bitter is for wimps. I'm fucking * HOMICIDAL. I want the fucking HEADS of all the DEC people * who have stalled on this ON FUCKING POLES OUTSIDE MY OFFICE. * Interrupt handled by the master ICU; * send an EOI to it for this level, because * they *appear* not to set up the ICU for * a mode that preserves the fully-nested * structure. * * Of course, given how FUCKING HELPFUL they've * been about answering questions and providing * documentation, I had to find that out by * DECOMPILING THE FUCKING INTERRUPT HANDLER * CODE IN OSF/1. * * I hope they FUCKING GO BANKRUPT, lose their * FUCKING jobs and ALL their FUCKING undeserved * self-esteem, and end up OUT ON THE FUCKING * STREET. * * I hate them. I hate talking to them. I hate sending * them mail. I hate *receiving* their mail. I hate * *reading* their mail. I want them all to die SLOWLY * IN HORRIBLE PAIN. */ /* * NB: As of 1999, they did, when Compaq and Intel * dismembered DEC like blood-maddened piranhas. * Requiescat in pace. */ 

Solía ​​haber una gran publicación en StackOverflow sobre este tema, pero un moderador demasiado entusiasta (que no debe ser identificado), por desgracia, lo eliminó. Para la referencia, estaba en < http://stackoverflow.com/questions/184618/what-is-the-best-comment-in-source-code-you-have-ever-encountered&gt ;.

Tengo la suerte de poder ver todas las respuestas eliminadas. Algunos de mis favoritos son:

  // 
 // Estimado mantenedor:
 // 
 // Una vez que haya terminado de "optimizar" esta rutina,
 // y me he dado cuenta de que fue un terrible error,
 // por favor incrementa el siguiente contador como una advertencia
 // al siguiente chico:
 // 
 // total_hours_wasted_here = 42
 // 
  // Cuando escribí esto, solo Dios y yo entendimos lo que estaba haciendo
 // Ahora, solo Dios sabe 

(Originalmente por Karl Weierstrass en relación con su trabajo matemático.)

// sometimes I believe compiler ignores all my comments

  // Dedico todo este código, todo mi trabajo, a mi esposa, Darlene, que lo hará. 
 // Tengo que apoyarme a mí, a nuestros tres hijos y al perro una vez que se ponga 
 // lanzado al público. 

// drunk, fix later

// Magic. Do not touch.

  # defina VERDADERO FALSO
 // Felices depuradores 

long john; // silver

(Tan cursi es gracioso.)

long long ago; /* in a galaxy far far away */

(De hecho, esto se compila en C99 / C ++ 0x.)

  / **
  * Siempre devuelve true.
  * /
 booleano público isAvailable () {
     falso retorno;
 } 

(Esto prueba por qué el código es * siempre * mejor que los comentarios cuando sea posible.)

while ([fh offsetInFile] +12 <= imageoffs)
{
uint32_t sign = [fh readUInt32BE];
uint32_t marker = [fh readUInt32BE];
uint32_t chunklen = [fh readUInt32BE];
off_t nextchunk = [fh offsetInFile] + ((chunklen + 3) & ~ 3);
/ *
En este punto, me gustaría tomarme un momento para hablarles sobre el formato de Adobe PSD. PSD no es un buen formato. PSD ni siquiera es un mal formato. Llamarlo así sería un insulto a otros formatos incorrectos, como PCX o JPEG. No, PSD es un formato abismal. Después de haber trabajado en este código durante varias semanas, mi odio por la PSD se ha convertido en un fuego furioso que arde con la feroz pasión de un millón de soles.

Si hay dos formas diferentes de hacer algo, PSD hará ambas cosas, en diferentes lugares. Luego formará otras tres formas en las que ningún humano sano podría pensar, y también las hará. PSD hace de la inconsistencia una forma de arte. ¿Por qué, por ejemplo, decidió repentinamente que estos trozos particulares deberían alinearse con cuatro bytes, y que esta alineación no debería incluirse en el tamaño? Otros trozos en otros lugares no están alineados o están alineados con la alineación incluida en el tamaño. Aquí, sin embargo, no está incluido. Cualquiera de estos tres comportamientos estaría bien. Un formato sano escogería uno. PSD, por supuesto, usa los tres, y más.

Tratar de obtener datos de un archivo PSD es como tratar de encontrar algo en el ático de su excéntrico tío que murió en un extraño ataque de tiburones de agua dulce en su 58 cumpleaños. El último detalle puede no ser importante para los propósitos del símil, pero en este punto estoy pasando mucho tiempo imaginando destinos divertidos para las personas responsables de este formato de archivo de Rube Goldberg.

Anteriormente, traté de obtener las últimas especificaciones para el formato de archivo PSD. Para hacer esto, tuve que solicitarles permiso para solicitar que consideraran enviarme este sagrado tomo. Esto habría implicado enviarles por fax una copia de algún documento u otro, probablemente firmado con sangre. Solo puedo imaginar que hacen este proceso tan difícil porque están intensamente avergonzados de haber creado esta abominación. Naturalmente, no era tan ingenuo como para realizar este procedimiento, pero si lo hubiera hecho, habría impreso todas las páginas de las especificaciones y las habría incendiado a todas. Si estuviera en mi poder, reuniría cada copia de esas especificaciones y las lanzaría en una nave espacial directamente al sol.

PSD no es mi formato de archivo favorito.
* /
if (sign! = ‘8BIM’) break; // control de cordura

interruptor (marcador)
{
caso ‘Lr16’:
layers = [XeePhotoshopLayerParser parseLayersFromHandle: fh parentImage: self alphaFlag: NULL];
descanso;

De XeePhotoshopLoader.m – xee – Alojamiento de proyectos de Google

¡Quiero escribir comentarios así algún día! 🙂

Al calificar proyectos OOP:

System.out.println("Black magic! Only Saruman knows how this works...");

(todo el proyecto fue malo, así que al lado del grado escribí “no aprobarás” 😉)

El mismo proyecto tuvo un comentario olvidado:

return true; //true my ass! this doesn't work