Commit Graph

17 Commits

Author SHA1 Message Date
Gregory Szorc
3e949ee8fe Bug 1176642 - Use absolute_import in mach_commands.py files; r=glandium
This removes ambiguity as to which modules are being imported, making
import slightly faster as Python doesn't need to test so many
directories for file presence.

All files should already be using absolute imports because mach command
modules aren't imported to the package they belong to: they instead
belong to the "mach" package. So relative imports shouldn't have been
used.

--HG--
extra : commitid : 6tFME1KKfTD
extra : rebase_source : 78728f82f5487281620e00c2a8004cd5e1968087
2015-06-21 17:39:09 -07:00
Gregory Szorc
a19bee3a08 Bug 1176642 - Remove unused imports; r=glandium
--HG--
extra : commitid : IZ7JkH4GKW4
extra : rebase_source : 4c3301c5c353be8afed407df4a003a9cac4583e8
2015-06-25 12:16:38 -07:00
Gregory Szorc
6d6343a1cd Bug 1115278 - Add virtualenv to Sphinx environment; r=glandium
Python API documentation requires the ability to import modules. So, we
set up a virtualenv in our Sphinx environment so module loading works.

This solution isn't perfect: a number of modules fail to import when run
under sphinx-build.

--HG--
extra : rebase_source : fce732e0b8aefe0e9a2ee594b8a08ac02e27579a
extra : histedit_source : bef27c947b95c3182fbc6cd656ae8c96acaaa6f4
2014-12-24 10:17:02 -08:00
Gregory Szorc
e96948d5a8 Bug 1115278 - Move Sphinx documentation staging into Sphinx extension; r=glandium
Previously, code for staging the Sphinx documentation from moz.build
metadata lived in a mach command and in the moztreedocs module. This
patch moves the invocation to the Sphinx extension.

When the code is part of the Sphinx extension, it will run when executed
with sphinx-build. This is a prerequisite to getting RTD working, since
sphinx-build is the only supported entrypoint for generating
documentation there.

With this patch, we can now invoke sphinx-build to build the
documentation. The `mach build-docs` command is no longer needed.

--HG--
extra : rebase_source : 86e76c7d598ffa23dae858254eecedbdd12706a4
extra : histedit_source : 1826aa5ddfafdff62847cc293d1f0950b236caac
2014-12-24 09:46:41 -08:00
Gregory Szorc
9d5bd72a6e Bug 1115278 - Store docs directory in a variable; r=glandium
--HG--
extra : rebase_source : b23e3e6202a2ea4b6f8ed24cdcf2698dededf6b6
extra : histedit_source : bfa988fb2259a03439700dfc894eefdeb2bb4a98
2014-12-23 23:18:48 -08:00
Gregory Szorc
468e18d939 Bug 1115278 - Move Sphinx build scanning into moztreedocs; r=glandium
In order for Sphinx documentation to work with Read The Docs, we need
the code for scanning the build config for Sphinx documentation to live
in an importable module. This patch moves some code from the
|build-docs| mach command into an importable module.

--HG--
extra : rebase_source : 263972d1415419c59c25058ca2cb90b3c31eda89
extra : histedit_source : e120aa117c63d54f6b293ae63d9bd1338ea0e808
2014-12-23 22:53:50 -08:00
Gregory Szorc
c6f29ac3f2 Bug 1091722 - Don't require configure before generating docs; r=glandium
Ever since Sphinx variable reading operates at the AST level (bug
1071012), we don't technically need a fully configured environment in
order to generate the documentation!

This patch stubs out the config environment object with a fake one that
provides the only needed context to generate the Sphinx docs. This
allows us to build the Sphinx docs on a fresh clone of the tree with no
configure and with no object directory.

--HG--
extra : rebase_source : f44513f01706391a5932a20c1437fcc8697611cd
2014-10-30 10:37:00 -07:00
Gregory Szorc
6829c039db Bug 1091722 - Use Read The Docs theme for Sphinx; r=glandium
Read the Docs has a lovely Sphinx theme that beats the pants off the
built-in and default theme. And since it looks like MDN's Sphinx theme
is dead in the water, this gets us a nice UI win until the MDN theme
comes back from the dead.

--HG--
extra : rebase_source : b4f92cf8263843d3118a85a7d9b59b98d5dd0613
2014-10-30 10:09:29 -07:00
Gregory Szorc
d0156c0f68 Bug 1091722 - Remove requirements.txt; r=glandium
requirements.txt isn't being used by the documentation infrastructure.
We nuke it.

--HG--
extra : rebase_source : d53ee5c329790d0ed7d75d6d9f451269dda6c485
2014-10-30 10:51:17 -07:00
Gregory Szorc
bf611d5f95 Bug 1071012 - Extract Sphinx variables via AST reading; r=glandium
The in-tree Sphinx docs have been broken since bug 1041941 because
processing moz.build files outside their context doesn't work.
Specifically, templates aren't loaded (because this information usually
comes from a parent moz.build file). A new execution mode is needed.

I tried to implement a proper execution mode. However, I kept running
into walls. While we should strive for a proper execution mode, this can
be a follow-up, tracked in bug 1058359.

This patch implements extraction of Sphinx variables from ast walking.
It is extremely low-level and definitely a one-off. But it solves the
problem at hand: |mach build-docs| will work after this patch is
applied.

--HG--
extra : rebase_source : abd0a91a3efb24d3adfa19f4cd281ce5fd6d0915
extra : amend_source : c1b4f79224bab55e65a8c2b0f3103475281416c1
2014-10-07 10:36:27 -07:00
Mike Hommey
f287c057c6 Bug 1053140 part 3 - Separate out sandbox infrastructure from moz.build variables storage. r=gps
--HG--
rename : python/mozbuild/mozbuild/frontend/sandbox_symbols.py => python/mozbuild/mozbuild/frontend/context.py
rename : python/mozbuild/mozbuild/test/frontend/test_sandbox_symbols.py => python/mozbuild/mozbuild/test/frontend/test_context.py
2014-08-15 13:52:18 +09:00
Gregory Szorc
5b730a4079 Bug 1040416 - Remove javasphinx extension from Sphinx config; r=nalexander
The extension was added by accident in bug 1033686.

DONTBUILD (NPOTB)

--HG--
extra : rebase_source : 18c2679d14b83ddf6f284052609a39ed2f405929
2014-07-23 09:22:48 -07:00
Eric Edens
387fa5673a Bug 1033686 - Make sure pre-search and post-search replace each other. r=nalexander
--HG--
rename : mobile/android/search/java/org/mozilla/search/DetailActivity.java => mobile/android/search/java/org/mozilla/search/PostSearchFragment.java
rename : mobile/android/search/java/org/mozilla/search/stream/CardStreamFragment.java => mobile/android/search/java/org/mozilla/search/PreSearchFragment.java
rename : mobile/android/search/java/org/mozilla/search/autocomplete/AutoCompleteFragment.java => mobile/android/search/java/org/mozilla/search/autocomplete/SearchFragment.java
2014-07-11 11:42:37 -07:00
Gregory Szorc
f67d95ca12 Bug 987332 - Disable MDN theme until it works; r=nalexander
The MDN theme is currently busted. This patch reverts to the default
Sphinx theme so we have docs that are more usable.

DONTBUILD (NPOTB)

--HG--
extra : rebase_source : 407dedaa2c200560a5e972998489f19a4bcdbe11
2014-06-16 14:53:49 -07:00
Gregory Szorc
abf326e01b Bug 949906 - Add a callback to modify evaluated moz.build sandboxes, fix Sphinx docs; r=glandium
--HG--
extra : rebase_source : 9ef2219145fb754a9cbe9e7e30b6f2841910f13f
2013-12-13 16:06:53 +09:00
Gregory Szorc
edbe43df4f Bug 939367 - Part 2: Move requirements.txt into tools/docs
Trivial change. No review.

DONTBUILD (NPOTB)

--HG--
rename : build/docs/requirements.txt => tools/docs/requirements.txt
2013-12-12 18:10:04 +09:00
Gregory Szorc
95aca92ee2 Bug 939367 - Allow Sphinx docs to come from all over the tree; r=glandium
--HG--
extra : rebase_source : 1c1a444a78c0dfce110db3890e29543eeb67f3aa
2013-11-20 12:37:22 -08:00