id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
27814	Unclear explanation of orphans in Paginator	Pablo Oubiña	nobody	"Hi there!

From [https://docs.djangoproject.com/en/1.10/topics/pagination/#optional-arguments/ Django documentation]:
''""**Paginator** objects
...
**orphans**
The minimum number of items allowed on the last page, defaults to zero...""'' 

Current implementation:
{{{
>>> from django.core.paginator import Paginator
>>> objects = ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h']
>>> p = Paginator(objects, 3, orphans=2)
>>> page2 = p.page(2)
>>> page2.object_list
output: ['d', 'e', 'f', 'g', 'h']
>>> page2.has_next()
output: False
}}}

As I understand it:
{{{
>>> from django.core.paginator import Paginator
>>> objects = ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h']
>>> p = Paginator(objects, 3, orphans=2)
>>> page2 = p.page(2)
>>> page2.object_list
output: ['d', 'e', 'f']
>>> page2.has_next()
output: True
>>> page3 = p.page(3)
>>> page3.object_list
output: ['g', 'h']
}}}

In my opinion, the **''orphans''** definition is confusing. What do you think? Am I missing something?

Thanks."	Bug	closed	Documentation	1.10	Normal	fixed	paginator, orphans,		Accepted	1	0	0	0	0	0