From 7c2b8621a3e8080d86907ec6172e3d18b1cda978 Mon Sep 17 00:00:00 2001 From: auouymous Date: Thu, 12 Jan 2023 15:04:26 -0700 Subject: [PATCH] Document the episode description fields. --- src/gpodder/model.py | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/src/gpodder/model.py b/src/gpodder/model.py index ed85dc03..10bcfaef 100644 --- a/src/gpodder/model.py +++ b/src/gpodder/model.py @@ -292,6 +292,11 @@ class PodcastEpisode(PodcastModelObject): episode.title = entry['title'] episode.link = entry['link'] episode.episode_art_url = entry.get('episode_art_url') + + # Only one of the two description fields should be set at a time. + # This keeps the database from doubling in size and reduces load time from slow storage. + # episode._text_description is initialized by episode.cache_text_description() from the set field. + # episode.html_description() returns episode.description_html or generates from episode.description. if entry.get('description_html'): episode.description = '' episode.description_html = entry['description_html']