Adding comments about legacy code for existing projects that have man/dash format builds.

Author: gregmuellegger

readthedocs/builds/constants.py

@@ -12,6 +12,9 @@
     ('html', _('HTML')),
     ('pdf', _('PDF')),
     ('epub', _('Epub')),
+    # There is currently no support for building man/dash formats, but we keep
+    # it there since the DB might still contain those values for legacy
+    # projects.
     ('man', _('Manpage')),
     ('dash', _('Dash')),
 )

readthedocs/projects/models.py

@@ -509,18 +509,22 @@ def full_latex_path(self, version='latest'):
         """
         return os.path.join(self.conf_dir(version), "_build", "latex")
 
-    def full_man_path(self, version='latest'):
-        """
-        The path to the build man docs in the project.
-        """
-        return os.path.join(self.conf_dir(version), "_build", "man")
-
     def full_epub_path(self, version='latest'):
         """
         The path to the build epub docs in the project.
         """
         return os.path.join(self.conf_dir(version), "_build", "epub")
 
+    # There is currently no support for building man/dash formats, but we keep
+    # the support there for existing projects. They might have already existing
+    # legacy builds.
+
+    def full_man_path(self, version='latest'):
+        """
+        The path to the build man docs in the project.
+        """
+        return os.path.join(self.conf_dir(version), "_build", "man")
+
     def full_dash_path(self, version='latest'):
         """
         The path to the build dash docs in the project.