[issue36329] use the right python "make -C Doc/ serve"

[Hugo van Kemenade]

Hugo van Kemenade  added the comment:

I've made PRs for this:

CPython Docs: https://github.com/python/cpython/pull/32354
Devguide: https://github.com/python/devguide/pull/826

Also set this bpo for Python 3.11.

--
versions: +Python 3.11 -Python 3.8

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue36329] use the right python "make -C Doc/ serve"

[Hugo van Kemenade]

Change by Hugo van Kemenade :


--
nosy: +hugovk
nosy_count: 4.0 -> 5.0
pull_requests: +30406
pull_request: https://github.com/python/cpython/pull/32354

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue36329] use the right python "make -C Doc/ serve"

[Berker Peksag]

Berker Peksag  added the comment:

Yeah, we can add htmlview to devguide. I’ve even added it to Django after I
discovered it in CPython :)
-- 
--Berker

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue36329] use the right python "make -C Doc/ serve"

[Stéphane Wirtel]

Stéphane Wirtel  added the comment:

>Personally, I'd prefer removing the 'serve' target completely. make -C
>Doc htmlview should already cover most of its use cases. There is no
>deprecation period needed and there is already a replacement (and IMO
>better) for it.

Hi Berker,

When I have read your message, I was surprised because this target
already exists since 2010. It's true we can run the makefile with 

my current workflow is 

make -C Doc/ venv && make -C Doc/ html serve and open my browser at
http://localhost:8000

but with your suggestion, I think it's better for us and also for the
contributors, just make -C Doc/ venv htmlview. This target will open the
browser with the result of the html build.

So, I have discussed with @Julien Palard and he told me that he did not
use the 'serve' target and he discovered the target via my issue.

But there will be an other issue, in the devguide, there is also a
'serve' target in the Makefile with a copy of tools/serve.py.

But there is no htmlview target. 

For the moment, we have a common solution for the two project if we want
to show the result to the user, make serve.

We could:

* remove 'make serve' from CPython and Devguide
* remove tools/serve.py from CPython and Devguide
* add htmlview to the DevGuide
* update the documentation 

+1 for removing the serve.py script and use htmlview.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue36329] use the right python "make -C Doc/ serve"

[Berker Peksag]

Berker Peksag  added the comment:

Personally, I'd prefer removing the 'serve' target completely. make -C Doc 
htmlview should already cover most of its use cases. There is no deprecation 
period needed and there is already a replacement (and IMO better) for it.

--
nosy: +berker.peksag

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue36329] use the right python "make -C Doc/ serve"

[Julien Palard]

Julien Palard  added the comment:


New changeset 09a9f1799c8c58f573c50cb2d526422436b8658b by Julien Palard 
(Stéphane Wirtel) in branch 'master':
bpo-36329: Declare the version of Python to use for Tools/scripts/serve.py 
(#12385)
https://github.com/python/cpython/commit/09a9f1799c8c58f573c50cb2d526422436b8658b


--
nosy: +mdk

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue36329] use the right python "make -C Doc/ serve"

[Stéphane Wirtel]

Change by Stéphane Wirtel :


--
keywords: +patch
pull_requests: +12342
stage:  -> patch review

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue36329] use the right python "make -C Doc/ serve"

[Stéphane Wirtel]

New submission from Stéphane Wirtel :

When serving the documentation with `make -C Doc/ serve`, we can not specify 
the path of the python binary.

My use case, I wanted to debug the wsgiref.simple_server method, used by 
Tools/scripts/serve.py. It's just impossible because  we use the default 
python3 binary from the system or from the virtualenv (pyenv. etc...)

--
messages: 338135
nosy: matrixise
priority: normal
severity: normal
status: open
title: use the right python "make -C Doc/ serve"
versions: Python 3.8

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue36329] use the right python "make -C Doc/ serve"

[Stéphane Wirtel]

Change by Stéphane Wirtel :


--
assignee:  -> docs@python
components: +Documentation
nosy: +docs@python

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com