search

lkiesow / python-feedgen

Python module to generate ATOM feeds, RSS feeds and Podcasts.
https://feedgen.kiesow.be/
BSD 2-Clause "Simplified" License
723 stars 123 forks source link

docs confusion #52

Closed thomasballinger closed 8 years ago

thomasballinger commented 8 years ago

In https://github.com/lkiesow/python-feedgen#create-a-feed I'm confused about link appearing twice:

...
fg.link( href='http://example.com', rel='alternate' )
fg.logo('http://ex.com/logo.jpg')
fg.subtitle('This is a cool feed!')
fg.link( href='http://larskiesow.de/test.atom', rel='self' )
...

Is this another way to "set fields that can occur more than once?" in addition to the three bulleted points below that? I assumed so at first, but then was confused that the technique of calling the method again didn't appear in that list.

lkiesow commented 8 years ago

Sorry for the late reply. I'm actually confused about your question. Calling the method multiple times will add additional links if the replace argument is not set to True. It's documented on the method.

thomasballinger commented 8 years ago

Indeed, reading my complaint now it doesn't make sense to me. I think I completely misread the list of ways to call these methods: I thought it was a list of ways to specify multiple values in a single call. The docs are plenty clear.