javascript函数的第一行:

// this part is more difficult

WTF?

在一个项目中，我们有一个依赖ppwlib，当时它的FreeBSD端口有点糟糕，所以我不得不从源代码手动构建它。但它并没有立即起作用，我不得不研究代码;有一些复杂的类层次结构，部分代码是由宏生成的，其父类声明以它们开始

// The root of all evil ... umm classes

//把这个放在这里的人是个白痴…这根本不管用!

但是代码还在那里……

有一次，我问一个同事如何用我们的内部框架做一些事情(忘了具体是什么，一些晦涩的技术调用)。 他说“简单，看这里”，然后在他的编辑器中打开一个。java文件，在几页代码中间给我看了这个注释:

// HERE

我刚刚检查了一下，注释仍然在这个文件中:)

//Maybe you should make anyone knows your code's purpose. 

场景一:

return 0; // Happy ending

场景二:

int32_t Interpolate1DSignal(
  Array1D<float64>::Handle hfInputSamples,         // samples to be interpolated
  Array1D<float64>::Handle hfInterpolationFilter,  // polyphase filter coefficients,
  int32_t iFilterInterpolationFactor,              // # of "rows" in polyphase filter
  int32_t iFilterLength,                           // Length of each row in filter
  float64 fInterpolationFactor,                    // Factor to interpolate the
                                                   // signal by
  float64 fTimingOffset,                           // Offset into the signal (units   
                                                   // of samples)
  Array1D<float64>::Handle hfOutputSamples         // left as an exercise for the reader
);