XML Comments - ¿Cómo comentar múltiples razones para una excepción?

Question

He aquí un ejemplo:

public void DoSomething(String param1, String param2) 
{ 
    if (param1 == null) throw new ArgumentNullException("param1"); 
    if (param2 == null) throw new ArgumentNullException("param2"); 
} 

2 razones diferentes para una ArgumentNullException. MSDNs String.Format Example muestra 2 motivos diferentes para el FormatException. Entonces, ¿se hace de esta manera:

/// <exception cref="ArgumentNullException"> 
///  <paramref name="param1"/> is null. 
/// </exception> 
/// <exception cref="ArgumentNullException"> 
///  <paramref name="param2"/> is null. 
/// </exception> 

o de alguna otra manera?

/// <exception cref="ArgumentNullException"> 
///  Some other way to show the 2 reasons with an "-or-" between them. 
/// </exception> 

Answer 1

Si cree que cada una de las filas de los documentos como uno <exception cref=...> </exception>, entonces lógicamente la forma correcta de hacerlo es usando su segunda alternativa:

/// <exception cref="ArgumentNullException"> 
///  <p><paramref name="param1"/> is null. </p> 
///  <p>- or - </p> 
///  <p><paramref name="param2"/> is null. </p> 
/// </exception> 

Puede utilizar elementos 'p' para denotar las líneas.