Bueno... esa variable fue introducida en la versión 1.5 de Paginator.
Como ya he explicado, Paginator utiliza la función COUNT() de mysql modificando el sql original mediante expresiones regulares...
Pero a través de los comentarios de los usuarios empecé a ver que no siempre este cambio funciona correctamente. Como ejemplo puedo poner un sql que contenga la cláusula GROUP BY... al combinarla con el COUNT() dará resultados, pero no los que esperamos.
Por eso creí conveniente que Paginator tuviera una forma alternativa de contar registros (que es la que todo el mundo utiliza) simplemente con mysql_num_rows(). Pero esto debería ser utilizado sólo frente a consultas complejas...
En la web de Paginator se explica más o menos la función que cumple esta variable. Pero es así como lo he puesto aquí.
Lo que recomiendo siempre es leer el ejemplo de la web y luego el "ejemplo avanzado" que ya incluye la utilización de la variables disponibles.
http://jpinedo.webcindario.com/scrip..._avanzado.html
Saludos