я оставил одну $i как кто то выше посоветовал...

ROMERO, запомните, программирование - это не какая-то магия, там всегда всё логично. Во многих случаях не надо знать языка и даже уметь программировать, достаточно развитой логики.

JHTML::_('select.option',$i,$i.'- комнатная квартира');

это просто вызов функции JHTML::_ с тремя разделёнными запятой параметрами,
где первый параметр 'select.option' - говотрит что мы генерируем <option> для <select>;
второй параметр $i задаёт value для этого <option>;
третий параметр $i.'- комнатная квартира' - задаёт текст для этого <option>.
В итоге мы получаем

<select>
    <option value="$i">$i.'- комнатная квартира'</option>
</select>

где $i - переменная php содержащая цифру;
. - оператор php означающий склеивание текста;
'- комнатная квартира' - просто текст.
Поэтому убрав "вторую $i" вы просто перестали склевать отображаемый текст с цифрой.

Но в целом это всё основы основ, если собираетесь делать хоть что-то отличное от стандарта - вам таки придётся их изучить.

Спасибо за краткий ликбез!
Может какие книжки достойные можете порекомендовать, хотя бы для неглубокого изучения вопроса? Для общего знакомства, так сказать...