mirror of
				https://github.com/jlu5/PyLink.git
				synced 2025-11-04 00:47:21 +01:00 
			
		
		
		
	utils: clarify ServiceBot.(join|part) docstrings
This commit is contained in:
		
							parent
							
								
									0ccaac595b
								
							
						
					
					
						commit
						0c55569c1f
					
				
							
								
								
									
										12
									
								
								utils.py
									
									
									
									
									
								
							
							
						
						
									
										12
									
								
								utils.py
									
									
									
									
									
								
							@ -153,11 +153,15 @@ class ServiceBot():
 | 
			
		||||
    def join(self, irc, channels, ignore_empty=True):
 | 
			
		||||
        """
 | 
			
		||||
        Joins the given service bot to the given channel(s). "channels" can be
 | 
			
		||||
        an iterable of channel names or the name of a single channel (str).
 | 
			
		||||
        an iterable of channel names or the name of a single channel (type 'str').
 | 
			
		||||
 | 
			
		||||
        The ignore_empty option sets whether we should skip joining empty
 | 
			
		||||
        channels and join them later when we see someone else join. This is
 | 
			
		||||
        option is disabled on networks where we cannot monitor channel state.
 | 
			
		||||
        channels and join them later when we see someone else join (for channels
 | 
			
		||||
        marked persistent). This option is automatically *disabled* on networks
 | 
			
		||||
        where we cannot monitor channels that we're not in (e.g. Clientbot).
 | 
			
		||||
 | 
			
		||||
        Before PyLink 2.0-alpha3, this function implicitly marks channels i
 | 
			
		||||
        receives to be persistent - this is no longer the case!
 | 
			
		||||
        """
 | 
			
		||||
        uid = self.uids.get(irc.name)
 | 
			
		||||
        if uid is None:
 | 
			
		||||
@ -201,7 +205,7 @@ class ServiceBot():
 | 
			
		||||
        still register it as a persistent dynamic channel.
 | 
			
		||||
 | 
			
		||||
        "channels" can be an iterable of channel names or the name of a single
 | 
			
		||||
        channel (str).
 | 
			
		||||
        channel (type 'str').
 | 
			
		||||
        """
 | 
			
		||||
        uid = self.uids.get(irc.name)
 | 
			
		||||
        if uid is None:
 | 
			
		||||
 | 
			
		||||
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user