[ci skip] docs fixes for some Sphinx warnings/errors

warrickball · warrickball · commit c25c7f2f5cb1 · 2023-12-24T20:56:56.000Z
diff --git a/astero/defaults/astero_search.defaults b/astero/defaults/astero_search.defaults
@@ -49,7 +49,7 @@
    ! + ``Rcz``
 
    ! where ``M_H``, ``surface_Z_div_X``, ``surface_He`` and ``Rcz``
-   ! are now implemented in the standard ``run_star_extras.f90`.
+   ! are now implemented in the standard ``run_star_extras.f90``.
    ! The other options fall back to the history columns.
 
    ! To implement your own constraints, create the appropriate case
@@ -621,7 +621,7 @@
    ! ~~~~
    ! Legacy controls from the old interface, which is available with
    ! the default ``run_star_extras.f90`` by using the parameter names
-   ! ``initial_Y`` and ``initial_FeH`.
+   ! ``initial_Y`` and ``initial_FeH``.
 
    ! If ``Y_depends_on_Z = .false.``, ``Y`` is a parameter like any other and you should set
    ! ``vary_Y``, ``first_Y``, ``min_Y`` and ``max_Y`` (and ``delta_Y`` for a grid).
diff --git a/docs/source/developing/collaboration.rst b/docs/source/developing/collaboration.rst
@@ -27,7 +27,7 @@ MESA (e.g., contribute a hook/routine, make a pull request).
 
 *MESA Developers (MD)*: These are individuals committed to improving
 MESA and its infrastructure (e.g., the MESA Test Hub). Instructions on how to become
-a developer are found :doc:`here <developing/new_developers>`.
+a developer are found :doc:`here <new_developers>`.
 
 Responsibilities
 of developers include:
@@ -92,7 +92,7 @@ fulfill their responsibilities, they must inform the MD.
 Removal from MD, MTC, and MAC can be for inactivity,
 harm to the Project, or simply opting out.
 
-Onboarding to the MD is described :doc:`here <developing/new_developers>`.
+Onboarding to the MD is described :doc:`here <new_developers>`.
 
 Instrument Paper Principles
 ===========================
diff --git a/docs/source/news/2016-02-03-r8118.rst b/docs/source/news/2016-02-03-r8118.rst
@@ -12,7 +12,7 @@ post <https://lists.mesastar.org/pipermail/mesa-users/2016-February/006205.html>
 to learn more.
 
 -  Almost all extras routines in run_star_extras and run_binary_extras
-   are now implemented as hooks, in a similar way to all other_\*
+   are now implemented as hooks, in a similar way to all ``other_\*``
    routines. If you use a custom run_star_extras, you need to slightly
    modify it for it to be compatible with this and future versions.
 
diff --git a/docs/source/news/2017-09-01-three-updates.rst b/docs/source/news/2017-09-01-three-updates.rst
@@ -8,33 +8,27 @@ This week has seen three new/updated projects announced on mesa-users.
 announces <https://lists.mesastar.org/pipermail/mesa-users/2017-August/007853.html>`__
 `MESA-Docker <https://github.com/evbauer/MESA-Docker>`__:
 
-::
-
-   It’s a Docker container with MESA already installed, and it should
+   *It’s a Docker container with MESA already installed, and it should
    work with any OS that supports Docker, including Windows 10.  This
    should serve as a useful tool for those who are ready to invest
    some extra effort to step beyond the limited options of MESA-Web,
    but not yet comfortable configuring their environment for full
-   installation.
+   installation.*
 
 `Rob Farmer
 announces <https://lists.mesastar.org/pipermail/mesa-users/2017-August/007856.html>`__
 `pyMesa <https://github.com/rjfarmer/pyMesa>`__:
 
-::
-
-   This is a set of low level python bindings for MESA to allow easy
+   *This is a set of low level python bindings for MESA to allow easy
    access to the individual MESA modules.  This is aimed for those
    people who want to quickly get a result from a MESA module and
    don’t want to worry about getting fortran code compiled and
-   working.
+   working.*
 
 `Carl Fields
 announces <https://lists.mesastar.org/pipermail/mesa-users/2017-September/007864.html>`__
 updates to `MESA-Web <http://mesa-web.asu.edu/>`__:
 
-::
-
-   1. Users can now choose to upload a custom reaction rate.
-   2. More mixing parameters available for calculations.
-   3. Jobs now run for 4hrs or until iron core collapse.
+   1. *Users can now choose to upload a custom reaction rate.*
+   2. *More mixing parameters available for calculations.*
+   3. *Jobs now run for 4hrs or until iron core collapse.*
diff --git a/docs/source/summer_schools.rst b/docs/source/summer_schools.rst
@@ -1,31 +1,31 @@
 MESA Summer Schools
-=================
+===================
 
 ***
 MESA Summer School Programs -- this page under construction!
 ***
 
 History of the MESA Summer School Program
---------------------
+-----------------------------------------
 
 The MESA Summer Schools have traditionally been held in Santa Barbara, California, until 2022. The 2023 MESA Summer School program, branded as MESA@Konkoly, was held in Budapest, Hungary. As of 2023, MESA Summer Schools can be run anywhere in the world. The involvement of the MESA developers is encouraged, and we are happy to help. 
 
 
 How to run a MESA Summer School
---------------------
+-------------------------------
 
 Preparing a good program takes about a year. Historically, the program has taken place in the middle of August. Assuming this timing, preparations for next year's program should begin in September.
 
 
 1 year + out (September/October)
---------------------
+--------------------------------
 
 - Book a venue
 - Choose your organizational team
 
 
 9 months out (November)
---------------------
+-----------------------
 
 - Contact lecturers. Try to invite people with a diverse set of research areas and consider focusing on topics that have not been covered in past programs (see previous summer school pages and agendas for this information)
-- Contact TAs. 
+- Contact TAs. 
diff --git a/star/defaults/controls.defaults b/star/defaults/controls.defaults
@@ -4829,9 +4829,6 @@
     RGB_to_AGB_wind_switch = 1d-4
 
       ! The code will automatically choose between an RGB wind and an AGB wind.
-
-      ! ::
-
       ! The following names for the different schemes are recognized:
 
       ! + 'Reimers'
