http://git-wip-us.apache.org/repos/asf/logging-log4net/blob/8a5b4204/src/Appender/TextWriterAppender.cs ---------------------------------------------------------------------- diff --git a/src/Appender/TextWriterAppender.cs b/src/Appender/TextWriterAppender.cs index 9482607..fe42089 100644 --- a/src/Appender/TextWriterAppender.cs +++ b/src/Appender/TextWriterAppender.cs @@ -1,10 +1,10 @@ #region Apache License // -// Licensed to the Apache Software Foundation (ASF) under one or more +// Licensed to the Apache Software Foundation (ASF) under one or more // contributor license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright ownership. +// this work for additional information regarding copyright ownership. // The ASF licenses this file to you under the Apache License, Version 2.0 -// (the "License"); you may not use this file except in compliance with +// (the "License"); you may not use this file except in compliance with // the License. You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 @@ -54,13 +54,13 @@ namespace log4net.Appender /// Default constructor. /// </para> /// </remarks> - public TextWriterAppender() + public TextWriterAppender() { } /// <summary> /// Initializes a new instance of the <see cref="TextWriterAppender" /> class and - /// sets the output destination to a new <see cref="StreamWriter"/> initialized + /// sets the output destination to a new <see cref="StreamWriter"/> initialized /// with the specified <see cref="Stream"/>. /// </summary> /// <param name="layout">The layout to use with this appender.</param> @@ -90,7 +90,7 @@ namespace log4net.Appender /// </para> /// </remarks> [Obsolete("Instead use the default constructor and set the Layout & Writer properties")] - public TextWriterAppender(ILayout layout, TextWriter writer) + public TextWriterAppender(ILayout layout, TextWriter writer) { Layout = layout; Writer = writer; @@ -101,17 +101,17 @@ namespace log4net.Appender #region Public Instance Properties /// <summary> - /// Gets or set whether the appender will flush at the end + /// Gets or set whether the appender will flush at the end /// of each append operation. /// </summary> /// <value> /// <para> - /// The default behavior is to flush at the end of each + /// The default behavior is to flush at the end of each /// append operation. /// </para> /// <para> - /// If this option is set to <c>false</c>, then the underlying - /// stream can defer persisting the logging event to a later + /// If this option is set to <c>false</c>, then the underlying + /// stream can defer persisting the logging event to a later /// time. /// </para> /// </value> @@ -123,7 +123,7 @@ namespace log4net.Appender /// be recorded on disk when the application exits. This is a high /// price to pay even for a 20% performance gain. /// </remarks> - public bool ImmediateFlush + public bool ImmediateFlush { get { return m_immediateFlush; } set { m_immediateFlush = value; } @@ -137,19 +137,19 @@ namespace log4net.Appender /// The specified <see cref="TextWriter"/> must be open and writable. /// </para> /// <para> - /// The <see cref="TextWriter"/> will be closed when the appender + /// The <see cref="TextWriter"/> will be closed when the appender /// instance is closed. /// </para> /// <para> /// <b>Note:</b> Logging to an unopened <see cref="TextWriter"/> will fail. /// </para> /// </remarks> - virtual public TextWriter Writer + virtual public TextWriter Writer { get { return m_qtw; } - set + set { - lock(this) + lock(this) { Reset(); if (value != null) @@ -171,29 +171,29 @@ namespace log4net.Appender /// <remarks> /// <para> /// This method checks if an output target has been set and if a - /// layout has been set. + /// layout has been set. /// </para> /// </remarks> /// <returns><c>false</c> if any of the preconditions fail.</returns> - override protected bool PreAppendCheck() + override protected bool PreAppendCheck() { - if (!base.PreAppendCheck()) + if (!base.PreAppendCheck()) { return false; } - if (m_qtw == null) + if (m_qtw == null) { // Allow subclass to lazily create the writer PrepareWriter(); - if (m_qtw == null) + if (m_qtw == null) { ErrorHandler.Error("No output stream or file set for the appender named ["+ Name +"]."); return false; } } - if (m_qtw.Closed) + if (m_qtw.Closed) { ErrorHandler.Error("Output stream for appender named ["+ Name +"] has been closed."); return false; @@ -204,31 +204,31 @@ namespace log4net.Appender /// <summary> /// This method is called by the <see cref="M:AppenderSkeleton.DoAppend(LoggingEvent)"/> - /// method. + /// method. /// </summary> /// <param name="loggingEvent">The event to log.</param> /// <remarks> /// <para> - /// Writes a log statement to the output stream if the output stream exists - /// and is writable. + /// Writes a log statement to the output stream if the output stream exists + /// and is writable. /// </para> /// <para> /// The format of the output will depend on the appender's layout. /// </para> /// </remarks> - override protected void Append(LoggingEvent loggingEvent) + override protected void Append(LoggingEvent loggingEvent) { RenderLoggingEvent(m_qtw, loggingEvent); - if (m_immediateFlush) + if (m_immediateFlush) { m_qtw.Flush(); - } + } } /// <summary> /// This method is called by the <see cref="M:AppenderSkeleton.DoAppend(LoggingEvent[])"/> - /// method. + /// method. /// </summary> /// <param name="loggingEvents">The array of events to log.</param> /// <remarks> @@ -237,17 +237,17 @@ namespace log4net.Appender /// before flushing the stream. /// </para> /// </remarks> - override protected void Append(LoggingEvent[] loggingEvents) + override protected void Append(LoggingEvent[] loggingEvents) { foreach(LoggingEvent loggingEvent in loggingEvents) { RenderLoggingEvent(m_qtw, loggingEvent); } - if (m_immediateFlush) + if (m_immediateFlush) { m_qtw.Flush(); - } + } } /// <summary> @@ -256,7 +256,7 @@ namespace log4net.Appender /// <remarks> /// Closed appenders cannot be reused. /// </remarks> - override protected void OnClose() + override protected void OnClose() { lock(this) { @@ -265,8 +265,8 @@ namespace log4net.Appender } /// <summary> - /// Gets or set the <see cref="IErrorHandler"/> and the underlying - /// <see cref="QuietTextWriter"/>, if any, for this appender. + /// Gets or set the <see cref="IErrorHandler"/> and the underlying + /// <see cref="QuietTextWriter"/>, if any, for this appender. /// </summary> /// <value> /// The <see cref="IErrorHandler"/> for this appender. @@ -278,18 +278,18 @@ namespace log4net.Appender { lock(this) { - if (value == null) + if (value == null) { LogLog.Warn(declaringType, "TextWriterAppender: You have tried to set a null error-handler."); - } - else + } + else { base.ErrorHandler = value; - if (m_qtw != null) + if (m_qtw != null) { m_qtw.ErrorHandler = value; } - } + } } } } @@ -334,17 +334,17 @@ namespace log4net.Appender /// Closes the underlying <see cref="TextWriter"/>. /// </para> /// </remarks> - virtual protected void CloseWriter() + virtual protected void CloseWriter() { - if (m_qtw != null) + if (m_qtw != null) { - try + try { m_qtw.Close(); - } - catch(Exception e) + } + catch(Exception e) { - ErrorHandler.Error("Could not close writer ["+m_qtw+"]", e); + ErrorHandler.Error("Could not close writer ["+m_qtw+"]", e); // do need to invoke an error handler // at this late stage } @@ -352,7 +352,7 @@ namespace log4net.Appender } /// <summary> - /// Clears internal references to the underlying <see cref="TextWriter" /> + /// Clears internal references to the underlying <see cref="TextWriter" /> /// and other variables. /// </summary> /// <remarks> @@ -360,7 +360,7 @@ namespace log4net.Appender /// Subclasses can override this method for an alternate closing behavior. /// </para> /// </remarks> - virtual protected void Reset() + virtual protected void Reset() { WriteFooterAndCloseWriter(); m_qtw = null; @@ -374,9 +374,9 @@ namespace log4net.Appender /// Writes a footer as produced by the embedded layout's <see cref="ILayout.Footer"/> property. /// </para> /// </remarks> - virtual protected void WriteFooter() + virtual protected void WriteFooter() { - if (Layout != null && m_qtw != null && !m_qtw.Closed) + if (Layout != null && m_qtw != null && !m_qtw.Closed) { string f = Layout.Footer; if (f != null) @@ -394,9 +394,9 @@ namespace log4net.Appender /// Writes a header produced by the embedded layout's <see cref="ILayout.Header"/> property. /// </para> /// </remarks> - virtual protected void WriteHeader() + virtual protected void WriteHeader() { - if (Layout != null && m_qtw != null && !m_qtw.Closed) + if (Layout != null && m_qtw != null && !m_qtw.Closed) { string h = Layout.Header; if (h != null) @@ -422,7 +422,7 @@ namespace log4net.Appender /// <summary> /// Gets or sets the <see cref="log4net.Util.QuietTextWriter"/> where logging events - /// will be written to. + /// will be written to. /// </summary> /// <value> /// The <see cref="log4net.Util.QuietTextWriter"/> where logging events are written. @@ -430,7 +430,7 @@ namespace log4net.Appender /// <remarks> /// <para> /// This is the <see cref="log4net.Util.QuietTextWriter"/> where logging events - /// will be written to. + /// will be written to. /// </para> /// </remarks> protected QuietTextWriter QuietWriter @@ -445,20 +445,20 @@ namespace log4net.Appender /// <summary> /// This is the <see cref="log4net.Util.QuietTextWriter"/> where logging events - /// will be written to. + /// will be written to. /// </summary> private QuietTextWriter m_qtw; /// <summary> - /// Immediate flush means that the underlying <see cref="TextWriter" /> + /// Immediate flush means that the underlying <see cref="TextWriter" /> /// or output stream will be flushed at the end of each append operation. /// </summary> /// <remarks> /// <para> - /// Immediate flush is slower but ensures that each append request is + /// Immediate flush is slower but ensures that each append request is /// actually written. If <see cref="ImmediateFlush"/> is set to /// <c>false</c>, then there is a good chance that the last few - /// logging events are not actually persisted if and when the application + /// logging events are not actually persisted if and when the application /// crashes. /// </para> /// <para>
http://git-wip-us.apache.org/repos/asf/logging-log4net/blob/8a5b4204/src/Appender/TraceAppender.cs ---------------------------------------------------------------------- diff --git a/src/Appender/TraceAppender.cs b/src/Appender/TraceAppender.cs index 18dd480..acc910f 100644 --- a/src/Appender/TraceAppender.cs +++ b/src/Appender/TraceAppender.cs @@ -1,10 +1,10 @@ #region Apache License // -// Licensed to the Apache Software Foundation (ASF) under one or more +// Licensed to the Apache Software Foundation (ASF) under one or more // contributor license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright ownership. +// this work for additional information regarding copyright ownership. // The ASF licenses this file to you under the Apache License, Version 2.0 -// (the "License"); you may not use this file except in compliance with +// (the "License"); you may not use this file except in compliance with // the License. You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 @@ -29,15 +29,15 @@ namespace log4net.Appender /// </summary> /// <remarks> /// <para> - /// The application configuration file can be used to control what listeners - /// are actually used. See the MSDN documentation for the + /// The application configuration file can be used to control what listeners + /// are actually used. See the MSDN documentation for the /// <see cref="System.Diagnostics.Trace"/> class for details on configuring the /// trace system. /// </para> /// <para> /// Events are written using the <c>System.Diagnostics.Trace.Write(string,string)</c> - /// method. The event's logger name is the default value for the category parameter - /// of the Write method. + /// method. The event's logger name is the default value for the category parameter + /// of the Write method. /// </para> /// <para> /// <b>Compact Framework</b><br /> @@ -68,7 +68,7 @@ namespace log4net.Appender } /// <summary> - /// Initializes a new instance of the <see cref="TraceAppender" /> + /// Initializes a new instance of the <see cref="TraceAppender" /> /// with a specified layout. /// </summary> /// <param name="layout">The layout to use with this appender.</param> @@ -88,16 +88,16 @@ namespace log4net.Appender #region Public Instance Properties /// <summary> - /// Gets or sets a value that indicates whether the appender will + /// Gets or sets a value that indicates whether the appender will /// flush at the end of each write. /// </summary> /// <remarks> - /// <para>The default behavior is to flush at the end of each - /// write. If the option is set to<c>false</c>, then the underlying - /// stream can defer writing to physical medium to a later time. + /// <para>The default behavior is to flush at the end of each + /// write. If the option is set to<c>false</c>, then the underlying + /// stream can defer writing to physical medium to a later time. /// </para> /// <para> - /// Avoiding the flush operation at the end of each append results + /// Avoiding the flush operation at the end of each append results /// in a performance gain of 10 to 20 percent. However, there is safety /// trade-off involved in skipping flushing. Indeed, when flushing is /// skipped, then it is likely that the last few log events will not @@ -116,11 +116,11 @@ namespace log4net.Appender /// </summary> /// <remarks> /// <para> - /// Defaults to %logger which will use the logger name of the current + /// Defaults to %logger which will use the logger name of the current /// <see cref="LoggingEvent"/> as the category parameter. /// </para> /// <para> - /// </para> + /// </para> /// </remarks> public PatternLayout Category { @@ -141,7 +141,7 @@ namespace log4net.Appender /// Writes the logging event to the <see cref="System.Diagnostics.Trace"/> system. /// </para> /// </remarks> - override protected void Append(LoggingEvent loggingEvent) + override protected void Append(LoggingEvent loggingEvent) { // // Write the string to the Trace system @@ -151,18 +151,18 @@ namespace log4net.Appender #else System.Diagnostics.Trace.Write(RenderLoggingEvent(loggingEvent), m_category.Format(loggingEvent)); #endif - + // // Flush the Trace system if needed // - if (m_immediateFlush) + if (m_immediateFlush) { #if NETCF System.Diagnostics.Debug.Flush(); #else System.Diagnostics.Trace.Flush(); #endif - } + } } /// <summary> @@ -189,7 +189,7 @@ namespace log4net.Appender /// </summary> /// <remarks> /// <para> - /// Immediate flush is slower but ensures that each append request is + /// Immediate flush is slower but ensures that each append request is /// actually written. If <see cref="ImmediateFlush"/> is set to /// <c>false</c>, then there is a good chance that the last few /// logs events are not actually written to persistent media if and http://git-wip-us.apache.org/repos/asf/logging-log4net/blob/8a5b4204/src/Appender/UdpAppender.cs ---------------------------------------------------------------------- diff --git a/src/Appender/UdpAppender.cs b/src/Appender/UdpAppender.cs index 55770ff..db5d01d 100644 --- a/src/Appender/UdpAppender.cs +++ b/src/Appender/UdpAppender.cs @@ -1,10 +1,10 @@ #region Apache License // -// Licensed to the Apache Software Foundation (ASF) under one or more +// Licensed to the Apache Software Foundation (ASF) under one or more // contributor license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright ownership. +// this work for additional information regarding copyright ownership. // The ASF licenses this file to you under the Apache License, Version 2.0 -// (the "License"); you may not use this file except in compliance with +// (the "License"); you may not use this file except in compliance with // the License. You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 @@ -27,10 +27,10 @@ using log4net.Layout; using log4net.Core; using log4net.Util; -namespace log4net.Appender +namespace log4net.Appender { /// <summary> - /// Sends logging events as connectionless UDP datagrams to a remote host or a + /// Sends logging events as connectionless UDP datagrams to a remote host or a /// multicast group using an <see cref="UdpClient" />. /// </summary> /// <remarks> @@ -38,7 +38,7 @@ namespace log4net.Appender /// UDP guarantees neither that messages arrive, nor that they arrive in the correct order. /// </para> /// <para> - /// To view the logging results, a custom application can be developed that listens for logging + /// To view the logging results, a custom application can be developed that listens for logging /// events. /// </para> /// <para> @@ -48,27 +48,27 @@ namespace log4net.Appender /// </para> /// </remarks> /// <example> - /// This example shows how to log receive logging events that are sent - /// on IP address 244.0.0.1 and port 8080 to the console. The event is - /// encoded in the packet as a unicode string and it is decoded as such. + /// This example shows how to log receive logging events that are sent + /// on IP address 244.0.0.1 and port 8080 to the console. The event is + /// encoded in the packet as a unicode string and it is decoded as such. /// <code lang="C#"> /// IPEndPoint remoteEndPoint = new IPEndPoint(IPAddress.Any, 0); /// UdpClient udpClient; /// byte[] buffer; /// string loggingEvent; - /// - /// try + /// + /// try /// { /// udpClient = new UdpClient(8080); - /// - /// while(true) + /// + /// while(true) /// { /// buffer = udpClient.Receive(ref remoteEndPoint); /// loggingEvent = System.Text.Encoding.Unicode.GetString(buffer); /// Console.WriteLine(loggingEvent); /// } - /// } - /// catch(Exception e) + /// } + /// catch(Exception e) /// { /// Console.WriteLine(e.ToString()); /// } @@ -78,8 +78,8 @@ namespace log4net.Appender /// Dim udpClient as UdpClient /// Dim buffer as Byte() /// Dim loggingEvent as String - /// - /// Try + /// + /// Try /// remoteEndPoint = new IPEndPoint(IPAddress.Any, 0) /// udpClient = new UdpClient(8080) /// @@ -93,7 +93,7 @@ namespace log4net.Appender /// End Try /// </code> /// <para> - /// An example configuration section to log information using this appender to the + /// An example configuration section to log information using this appender to the /// IP 224.0.0.1 on port 8080: /// </para> /// <code lang="XML" escaped="true"> @@ -116,7 +116,7 @@ namespace log4net.Appender /// <remarks> /// The default constructor initializes all fields to their default values. /// </remarks> - public UdpAppender() + public UdpAppender() { } @@ -129,14 +129,14 @@ namespace log4net.Appender /// the underlying <see cref="UdpClient" /> should sent the logging event. /// </summary> /// <value> - /// The IP address of the remote host or multicast group to which the logging event + /// The IP address of the remote host or multicast group to which the logging event /// will be sent. /// </value> /// <remarks> /// <para> /// Multicast addresses are identified by IP class <b>D</b> addresses (in the range 224.0.0.0 to /// 239.255.255.255). Multicast packets can pass across different networks through routers, so - /// it is possible to use multicasts in an Internet scenario as long as your network provider + /// it is possible to use multicasts in an Internet scenario as long as your network provider /// supports multicasting. /// </para> /// <para> @@ -182,11 +182,11 @@ namespace log4net.Appender /// </para> /// <para> /// A complete list of actually reserved multicast addresses and their owners in the ranges - /// defined by RFC 3171 can be found at the <A href="http://www.iana.org/assignments/multicast-addresses">IANA web site</A>. + /// defined by RFC 3171 can be found at the <A href="http://www.iana.org/assignments/multicast-addresses">IANA web site</A>. /// </para> /// <para> - /// The address range 239.0.0.0 to 239.255.255.255 is reserved for administrative scope-relative - /// addresses. These addresses can be reused with other local groups. Routers are typically + /// The address range 239.0.0.0 to 239.255.255.255 is reserved for administrative scope-relative + /// addresses. These addresses can be reused with other local groups. Routers are typically /// configured with filters to prevent multicast traffic in this range from flowing outside /// of the local network. /// </para> @@ -198,12 +198,12 @@ namespace log4net.Appender } /// <summary> - /// Gets or sets the TCP port number of the remote host or multicast group to which + /// Gets or sets the TCP port number of the remote host or multicast group to which /// the underlying <see cref="UdpClient" /> should sent the logging event. /// </summary> /// <value> - /// An integer value in the range <see cref="IPEndPoint.MinPort" /> to <see cref="IPEndPoint.MaxPort" /> - /// indicating the TCP port number of the remote host or multicast group to which the logging event + /// An integer value in the range <see cref="IPEndPoint.MinPort" /> to <see cref="IPEndPoint.MaxPort" /> + /// indicating the TCP port number of the remote host or multicast group to which the logging event /// will be sent. /// </value> /// <remarks> @@ -214,17 +214,17 @@ namespace log4net.Appender public int RemotePort { get { return m_remotePort; } - set + set { - if (value < IPEndPoint.MinPort || value > IPEndPoint.MaxPort) + if (value < IPEndPoint.MinPort || value > IPEndPoint.MaxPort) { throw log4net.Util.SystemInfo.CreateArgumentOutOfRangeException("value", (object)value, - "The value specified is less than " + - IPEndPoint.MinPort.ToString(NumberFormatInfo.InvariantInfo) + - " or greater than " + + "The value specified is less than " + IPEndPoint.MinPort.ToString(NumberFormatInfo.InvariantInfo) + " or greater than " IPEndPoint.MaxPort.ToString(NumberFormatInfo.InvariantInfo) + "."); - } - else + } + else { m_remotePort = value; } @@ -235,7 +235,7 @@ namespace log4net.Appender /// Gets or sets the TCP port number from which the underlying <see cref="UdpClient" /> will communicate. /// </summary> /// <value> - /// An integer value in the range <see cref="IPEndPoint.MinPort" /> to <see cref="IPEndPoint.MaxPort" /> + /// An integer value in the range <see cref="IPEndPoint.MinPort" /> to <see cref="IPEndPoint.MaxPort" /> /// indicating the TCP port number from which the underlying <see cref="UdpClient" /> will communicate. /// </value> /// <remarks> @@ -251,17 +251,17 @@ namespace log4net.Appender public int LocalPort { get { return m_localPort; } - set + set { if (value != 0 && (value < IPEndPoint.MinPort || value > IPEndPoint.MaxPort)) { throw log4net.Util.SystemInfo.CreateArgumentOutOfRangeException("value", (object)value, - "The value specified is less than " + - IPEndPoint.MinPort.ToString(NumberFormatInfo.InvariantInfo) + - " or greater than " + + "The value specified is less than " + IPEndPoint.MinPort.ToString(NumberFormatInfo.InvariantInfo) + " or greater than " IPEndPoint.MaxPort.ToString(NumberFormatInfo.InvariantInfo) + "."); - } - else + } + else { m_localPort = value; } @@ -296,10 +296,10 @@ namespace log4net.Appender /// The underlying <see cref="UdpClient" />. /// </value> /// <remarks> - /// <see cref="UdpAppender" /> creates a <see cref="UdpClient" /> to send logging events + /// <see cref="UdpAppender" /> creates a <see cref="UdpClient" /> to send logging events /// over a network. Classes deriving from <see cref="UdpAppender" /> can use this /// property to get or set this <see cref="UdpClient" />. Use the underlying <see cref="UdpClient" /> - /// returned from <see cref="Client" /> if you require access beyond that which + /// returned from <see cref="Client" /> if you require access beyond that which /// <see cref="UdpAppender" /> provides. /// </remarks> protected UdpClient Client @@ -315,7 +315,7 @@ namespace log4net.Appender /// The cached remote endpoint to which the logging events will be sent. /// </value> /// <remarks> - /// The <see cref="ActivateOptions" /> method will initialize the remote endpoint + /// The <see cref="ActivateOptions" /> method will initialize the remote endpoint /// with the values of the <see cref="RemoteAddress" /> and <see cref="RemotePort"/> /// properties. /// </remarks> @@ -335,17 +335,17 @@ namespace log4net.Appender /// <remarks> /// <para> /// This is part of the <see cref="IOptionHandler"/> delayed object - /// activation scheme. The <see cref="ActivateOptions"/> method must + /// activation scheme. The <see cref="ActivateOptions"/> method must /// be called on this object after the configuration properties have /// been set. Until <see cref="ActivateOptions"/> is called this - /// object is in an undefined state and must not be used. + /// object is in an undefined state and must not be used. /// </para> /// <para> - /// If any of the configuration properties are modified then + /// If any of the configuration properties are modified then /// <see cref="ActivateOptions"/> must be called again. /// </para> /// <para> - /// The appender will be ignored if no <see cref="RemoteAddress" /> was specified or + /// The appender will be ignored if no <see cref="RemoteAddress" /> was specified or /// an invalid remote or local TCP port number was specified. /// </para> /// </remarks> @@ -355,27 +355,27 @@ namespace log4net.Appender { base.ActivateOptions(); - if (this.RemoteAddress == null) + if (this.RemoteAddress == null) { throw new ArgumentNullException("The required property 'Address' was not specified."); - } - else if (this.RemotePort < IPEndPoint.MinPort || this.RemotePort > IPEndPoint.MaxPort) + } + else if (this.RemotePort < IPEndPoint.MinPort || this.RemotePort > IPEndPoint.MaxPort) { throw log4net.Util.SystemInfo.CreateArgumentOutOfRangeException("this.RemotePort", (object)this.RemotePort, - "The RemotePort is less than " + - IPEndPoint.MinPort.ToString(NumberFormatInfo.InvariantInfo) + - " or greater than " + + "The RemotePort is less than " + IPEndPoint.MinPort.ToString(NumberFormatInfo.InvariantInfo) + " or greater than " IPEndPoint.MaxPort.ToString(NumberFormatInfo.InvariantInfo) + "."); - } + } else if (this.LocalPort != 0 && (this.LocalPort < IPEndPoint.MinPort || this.LocalPort > IPEndPoint.MaxPort)) { throw log4net.Util.SystemInfo.CreateArgumentOutOfRangeException("this.LocalPort", (object)this.LocalPort, - "The LocalPort is less than " + - IPEndPoint.MinPort.ToString(NumberFormatInfo.InvariantInfo) + - " or greater than " + + "The LocalPort is less than " + IPEndPoint.MinPort.ToString(NumberFormatInfo.InvariantInfo) + " or greater than " IPEndPoint.MaxPort.ToString(NumberFormatInfo.InvariantInfo) + "."); - } - else + } + else { this.RemoteEndPoint = new IPEndPoint(this.RemoteAddress, this.RemotePort); this.InitializeClientConnection(); @@ -398,9 +398,9 @@ namespace log4net.Appender /// Exceptions are passed to the <see cref="AppenderSkeleton.ErrorHandler"/>. /// </para> /// </remarks> - protected override void Append(LoggingEvent loggingEvent) + protected override void Append(LoggingEvent loggingEvent) { - try + try { Byte [] buffer = m_encoding.GetBytes(RenderLoggingEvent(loggingEvent).ToCharArray()); #if NETSTANDARD1_3 @@ -408,15 +408,15 @@ namespace log4net.Appender #else this.Client.Send(buffer, buffer.Length, this.RemoteEndPoint); #endif - } - catch (Exception ex) + } + catch (Exception ex) { ErrorHandler.Error( - "Unable to send logging event to remote host " + - this.RemoteAddress.ToString() + - " on port " + - this.RemotePort + ".", - ex, + "Unable to send logging event to remote host " + this.RemoteAddress.ToString() + " on port " + this.RemotePort + ".", + ex, ErrorCode.WriteFailure); } } @@ -436,20 +436,20 @@ namespace log4net.Appender } /// <summary> - /// Closes the UDP connection and releases all resources associated with + /// Closes the UDP connection and releases all resources associated with /// this <see cref="UdpAppender" /> instance. /// </summary> /// <remarks> /// <para> - /// Disables the underlying <see cref="UdpClient" /> and releases all managed + /// Disables the underlying <see cref="UdpClient" /> and releases all managed /// and unmanaged resources associated with the <see cref="UdpAppender" />. /// </para> /// </remarks> - override protected void OnClose() + override protected void OnClose() { base.OnClose(); - if (this.Client != null) + if (this.Client != null) { this.Client.Close(); this.Client = null; @@ -465,16 +465,16 @@ namespace log4net.Appender /// </summary> /// <remarks> /// <para> - /// The underlying <see cref="UdpClient"/> is initialized and binds to the + /// The underlying <see cref="UdpClient"/> is initialized and binds to the /// port number from which you intend to communicate. /// </para> /// <para> /// Exceptions are passed to the <see cref="AppenderSkeleton.ErrorHandler"/>. /// </para> /// </remarks> - protected virtual void InitializeClientConnection() + protected virtual void InitializeClientConnection() { - try + try { if (this.LocalPort == 0) { @@ -492,13 +492,13 @@ namespace log4net.Appender this.Client = new UdpClient(this.LocalPort, RemoteAddress.AddressFamily); #endif } - } - catch (Exception ex) + } + catch (Exception ex) { ErrorHandler.Error( - "Could not initialize the UdpClient connection on port " + - this.LocalPort.ToString(NumberFormatInfo.InvariantInfo) + ".", - ex, + "Could not initialize the UdpClient connection on port " + this.LocalPort.ToString(NumberFormatInfo.InvariantInfo) + ".", + ex, ErrorCode.GenericFailure); this.Client = null; @@ -510,13 +510,13 @@ namespace log4net.Appender #region Private Instance Fields /// <summary> - /// The IP address of the remote host or multicast group to which + /// The IP address of the remote host or multicast group to which /// the logging event will be sent. /// </summary> private IPAddress m_remoteAddress; - + /// <summary> - /// The TCP port number of the remote host or multicast group to + /// The TCP port number of the remote host or multicast group to /// which the logging event will be sent. /// </summary> private int m_remotePort; @@ -532,7 +532,7 @@ namespace log4net.Appender private int m_localPort; /// <summary> - /// The <see cref="UdpClient" /> instance that will be used for sending the + /// The <see cref="UdpClient" /> instance that will be used for sending the /// logging events. /// </summary> private UdpClient m_client; http://git-wip-us.apache.org/repos/asf/logging-log4net/blob/8a5b4204/src/AssemblyInfo.cs ---------------------------------------------------------------------- diff --git a/src/AssemblyInfo.cs b/src/AssemblyInfo.cs index 4f47009..bd1f560 100644 --- a/src/AssemblyInfo.cs +++ b/src/AssemblyInfo.cs @@ -1,10 +1,10 @@ #region Apache License // -// Licensed to the Apache Software Foundation (ASF) under one or more +// Licensed to the Apache Software Foundation (ASF) under one or more // contributor license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright ownership. +// this work for additional information regarding copyright ownership. // The ASF licenses this file to you under the Apache License, Version 2.0 -// (the "License"); you may not use this file except in compliance with +// (the "License"); you may not use this file except in compliance with // the License. You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 @@ -48,7 +48,7 @@ using System.Runtime.CompilerServices; #endif // -// General Information about an assembly is controlled through the following +// General Information about an assembly is controlled through the following // set of attributes. Change these attribute values to modify the information // associated with an assembly. // @@ -130,29 +130,29 @@ using System.Runtime.CompilerServices; [assembly: AssemblyProduct("log4net")] [assembly: AssemblyDefaultAlias("log4net")] -[assembly: AssemblyCulture("")] - +[assembly: AssemblyCulture("")] + // -// In order to sign your assembly you must specify a key to use. Refer to the +// In order to sign your assembly you must specify a key to use. Refer to the // Microsoft .NET Framework documentation for more information on assembly signing. // -// Use the attributes below to control which key is used for signing. +// Use the attributes below to control which key is used for signing. // -// Notes: +// Notes: // (*) If no key is specified, the assembly is not signed. // (*) KeyName refers to a key that has been installed in the Crypto Service // Provider (CSP) on your machine. KeyFile refers to a file which contains // a key. -// (*) If the KeyFile and the KeyName values are both specified, the +// (*) If the KeyFile and the KeyName values are both specified, the // following processing occurs: // (1) If the KeyName can be found in the CSP, that key is used. -// (2) If the KeyName does not exist and the KeyFile does exist, the key +// (2) If the KeyName does not exist and the KeyFile does exist, the key // in the KeyFile is installed into the CSP and used. // (*) In order to create a KeyFile, you can use the sn.exe (Strong Name) utility. // When specifying the KeyFile, the location of the KeyFile should be // relative to the project output directory which is // %Project Directory%\obj\<configuration>. For example, if your KeyFile is -// located in the project directory, you would specify the AssemblyKeyFile +// located in the project directory, you would specify the AssemblyKeyFile // attribute as [assembly: AssemblyKeyFile("..\\..\\mykey.snk")] // (*) Delay Signing is an advanced option - see the Microsoft .NET Framework // documentation for more information on this. http://git-wip-us.apache.org/repos/asf/logging-log4net/blob/8a5b4204/src/AssemblyVersionInfo.cs ---------------------------------------------------------------------- diff --git a/src/AssemblyVersionInfo.cs b/src/AssemblyVersionInfo.cs index 668df06..0ed9380 100644 --- a/src/AssemblyVersionInfo.cs +++ b/src/AssemblyVersionInfo.cs @@ -1,10 +1,10 @@ #region Apache License // -// Licensed to the Apache Software Foundation (ASF) under one or more +// Licensed to the Apache Software Foundation (ASF) under one or more // contributor license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright ownership. +// this work for additional information regarding copyright ownership. // The ASF licenses this file to you under the Apache License, Version 2.0 -// (the "License"); you may not use this file except in compliance with +// (the "License"); you may not use this file except in compliance with // the License. You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 @@ -21,11 +21,11 @@ // Version information for an assembly consists of the following four values: // // Major Version -// Minor Version +// Minor Version // Build Number // Revision // -// You can specify all the values or you can default the Revision and Build Numbers +// You can specify all the values or you can default the Revision and Build Numbers // by using the '*' as shown below: [assembly: System.Reflection.AssemblyVersion("2.0.9.0")] http://git-wip-us.apache.org/repos/asf/logging-log4net/blob/8a5b4204/src/Config/AliasDomainAttribute.cs ---------------------------------------------------------------------- diff --git a/src/Config/AliasDomainAttribute.cs b/src/Config/AliasDomainAttribute.cs index 11906f6..95b2122 100644 --- a/src/Config/AliasDomainAttribute.cs +++ b/src/Config/AliasDomainAttribute.cs @@ -1,10 +1,10 @@ #region Apache License // -// Licensed to the Apache Software Foundation (ASF) under one or more +// Licensed to the Apache Software Foundation (ASF) under one or more // contributor license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright ownership. +// this work for additional information regarding copyright ownership. // The ASF licenses this file to you under the Apache License, Version 2.0 -// (the "License"); you may not use this file except in compliance with +// (the "License"); you may not use this file except in compliance with // the License. You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 @@ -54,7 +54,7 @@ namespace log4net.Config #region Public Instance Constructors /// <summary> - /// Initializes a new instance of the <see cref="AliasDomainAttribute" /> class with + /// Initializes a new instance of the <see cref="AliasDomainAttribute" /> class with /// the specified domain to alias to this assembly's repository. /// </summary> /// <param name="name">The domain to alias to this assemby's repository.</param> http://git-wip-us.apache.org/repos/asf/logging-log4net/blob/8a5b4204/src/Config/AliasRepositoryAttribute.cs ---------------------------------------------------------------------- diff --git a/src/Config/AliasRepositoryAttribute.cs b/src/Config/AliasRepositoryAttribute.cs index da83b77..64a881b 100644 --- a/src/Config/AliasRepositoryAttribute.cs +++ b/src/Config/AliasRepositoryAttribute.cs @@ -1,10 +1,10 @@ #region Apache License // -// Licensed to the Apache Software Foundation (ASF) under one or more +// Licensed to the Apache Software Foundation (ASF) under one or more // contributor license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright ownership. +// this work for additional information regarding copyright ownership. // The ASF licenses this file to you under the Apache License, Version 2.0 -// (the "License"); you may not use this file except in compliance with +// (the "License"); you may not use this file except in compliance with // the License. You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 @@ -49,18 +49,18 @@ namespace log4net.Config { // // Class is not sealed because AliasDomainAttribute extends it while it is obsoleted - // + // #region Public Instance Constructors /// <summary> - /// Initializes a new instance of the <see cref="AliasRepositoryAttribute" /> class with + /// Initializes a new instance of the <see cref="AliasRepositoryAttribute" /> class with /// the specified repository to alias to this assembly's repository. /// </summary> /// <param name="name">The repository to alias to this assemby's repository.</param> /// <remarks> /// <para> - /// Initializes a new instance of the <see cref="AliasRepositoryAttribute" /> class with + /// Initializes a new instance of the <see cref="AliasRepositoryAttribute" /> class with /// the specified repository to alias to this assembly's repository. /// </para> /// </remarks> http://git-wip-us.apache.org/repos/asf/logging-log4net/blob/8a5b4204/src/Config/BasicConfigurator.cs ---------------------------------------------------------------------- diff --git a/src/Config/BasicConfigurator.cs b/src/Config/BasicConfigurator.cs index 1f89ad2..a976d51 100644 --- a/src/Config/BasicConfigurator.cs +++ b/src/Config/BasicConfigurator.cs @@ -1,10 +1,10 @@ #region Apache License // -// Licensed to the Apache Software Foundation (ASF) under one or more +// Licensed to the Apache Software Foundation (ASF) under one or more // contributor license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright ownership. +// this work for additional information regarding copyright ownership. // The ASF licenses this file to you under the Apache License, Version 2.0 -// (the "License"); you may not use this file except in compliance with +// (the "License"); you may not use this file except in compliance with // the License. You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 @@ -67,7 +67,7 @@ namespace log4net.Config #region Private Instance Constructors /// <summary> - /// Initializes a new instance of the <see cref="BasicConfigurator" /> class. + /// Initializes a new instance of the <see cref="BasicConfigurator" /> class. /// </summary> /// <remarks> /// <para> @@ -134,7 +134,7 @@ namespace log4net.Config /// Initializes the log4net system using the specified appender. /// </para> /// </remarks> - static public ICollection Configure(IAppender appender) + static public ICollection Configure(IAppender appender) { return Configure(new IAppender[] { appender }); } @@ -153,7 +153,7 @@ namespace log4net.Config /// layout style. /// </para> /// </remarks> - static public ICollection Configure(ILoggerRepository repository) + static public ICollection Configure(ILoggerRepository repository) { ArrayList configurationMessages = new ArrayList(); @@ -215,8 +215,8 @@ namespace log4net.Config return configurationMessages; } - - static private void InternalConfigure(ILoggerRepository repository, params IAppender[] appenders) + + static private void InternalConfigure(ILoggerRepository repository, params IAppender[] appenders) { IBasicRepositoryConfigurator configurableRepository = repository as IBasicRepositoryConfigurator; if (configurableRepository != null) http://git-wip-us.apache.org/repos/asf/logging-log4net/blob/8a5b4204/src/Config/ConfiguratorAttribute.cs ---------------------------------------------------------------------- diff --git a/src/Config/ConfiguratorAttribute.cs b/src/Config/ConfiguratorAttribute.cs index e3da674..2d89165 100644 --- a/src/Config/ConfiguratorAttribute.cs +++ b/src/Config/ConfiguratorAttribute.cs @@ -1,10 +1,10 @@ #region Apache License // -// Licensed to the Apache Software Foundation (ASF) under one or more +// Licensed to the Apache Software Foundation (ASF) under one or more // contributor license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright ownership. +// this work for additional information regarding copyright ownership. // The ASF licenses this file to you under the Apache License, Version 2.0 -// (the "License"); you may not use this file except in compliance with +// (the "License"); you may not use this file except in compliance with // the License. You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 @@ -31,7 +31,7 @@ namespace log4net.Config /// Base class for all log4net configuration attributes. /// </summary> /// <remarks> - /// This is an abstract class that must be extended by + /// This is an abstract class that must be extended by /// specific configurators. This attribute allows the /// configurator to be parameterized by an assembly level /// attribute. http://git-wip-us.apache.org/repos/asf/logging-log4net/blob/8a5b4204/src/Config/DOMConfigurator.cs ---------------------------------------------------------------------- diff --git a/src/Config/DOMConfigurator.cs b/src/Config/DOMConfigurator.cs index 54551af..09c14c9 100644 --- a/src/Config/DOMConfigurator.cs +++ b/src/Config/DOMConfigurator.cs @@ -1,10 +1,10 @@ #region Apache License // -// Licensed to the Apache Software Foundation (ASF) under one or more +// Licensed to the Apache Software Foundation (ASF) under one or more // contributor license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright ownership. +// this work for additional information regarding copyright ownership. // The ASF licenses this file to you under the Apache License, Version 2.0 -// (the "License"); you may not use this file except in compliance with +// (the "License"); you may not use this file except in compliance with // the License. You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 @@ -51,8 +51,8 @@ namespace log4net.Config /// <summary> /// Private constructor /// </summary> - private DOMConfigurator() - { + private DOMConfigurator() + { } #endregion Protected Instance Constructors @@ -60,7 +60,7 @@ namespace log4net.Config #region Configure static methods /// <summary> - /// Automatically configures the log4net system based on the + /// Automatically configures the log4net system based on the /// application's configuration settings. /// </summary> /// <remarks> @@ -74,7 +74,7 @@ namespace log4net.Config /// <c>log4net</c> that contains the configuration data. /// </remarks> [Obsolete("Use XmlConfigurator.Configure instead of DOMConfigurator.Configure")] - static public void Configure() + static public void Configure() { XmlConfigurator.Configure(LogManager.GetRepository(Assembly.GetCallingAssembly())); } @@ -95,7 +95,7 @@ namespace log4net.Config /// </remarks> /// <param name="repository">The repository to configure.</param> [Obsolete("Use XmlConfigurator.Configure instead of DOMConfigurator.Configure")] - static public void Configure(ILoggerRepository repository) + static public void Configure(ILoggerRepository repository) { XmlConfigurator.Configure(repository); } @@ -112,13 +112,13 @@ namespace log4net.Config /// </remarks> /// <param name="element">The element to parse.</param> [Obsolete("Use XmlConfigurator.Configure instead of DOMConfigurator.Configure")] - static public void Configure(XmlElement element) + static public void Configure(XmlElement element) { XmlConfigurator.Configure(LogManager.GetRepository(Assembly.GetCallingAssembly()), element); } /// <summary> - /// Configures the <see cref="ILoggerRepository"/> using the specified XML + /// Configures the <see cref="ILoggerRepository"/> using the specified XML /// element. /// </summary> /// <remarks> @@ -131,7 +131,7 @@ namespace log4net.Config /// <param name="repository">The repository to configure.</param> /// <param name="element">The element to parse.</param> [Obsolete("Use XmlConfigurator.Configure instead of DOMConfigurator.Configure")] - static public void Configure(ILoggerRepository repository, XmlElement element) + static public void Configure(ILoggerRepository repository, XmlElement element) { XmlConfigurator.Configure(repository, element); } @@ -155,16 +155,16 @@ namespace log4net.Config /// normal application on <c>Web.config</c> for an ASP.NET application). /// </para> /// <example> - /// The following example configures log4net using a configuration file, of which the + /// The following example configures log4net using a configuration file, of which the /// location is stored in the application's configuration file : /// </example> /// <code lang="C#"> /// using log4net.Config; /// using System.IO; /// using System.Configuration; - /// + /// /// ... - /// + /// /// DOMConfigurator.Configure(new FileInfo(ConfigurationSettings.AppSettings["log4net-config-file"])); /// </code> /// <para> @@ -208,7 +208,7 @@ namespace log4net.Config } /// <summary> - /// Configures the <see cref="ILoggerRepository"/> using the specified configuration + /// Configures the <see cref="ILoggerRepository"/> using the specified configuration /// file. /// </summary> /// <param name="repository">The repository to configure.</param> @@ -228,16 +228,16 @@ namespace log4net.Config /// normal application on <c>Web.config</c> for an ASP.NET application). /// </para> /// <example> - /// The following example configures log4net using a configuration file, of which the + /// The following example configures log4net using a configuration file, of which the /// location is stored in the application's configuration file : /// </example> /// <code lang="C#"> /// using log4net.Config; /// using System.IO; /// using System.Configuration; - /// + /// /// ... - /// + /// /// DOMConfigurator.Configure(new FileInfo(ConfigurationSettings.AppSettings["log4net-config-file"])); /// </code> /// <para> @@ -259,7 +259,7 @@ namespace log4net.Config /// <summary> - /// Configures the <see cref="ILoggerRepository"/> using the specified configuration + /// Configures the <see cref="ILoggerRepository"/> using the specified configuration /// file. /// </summary> /// <param name="repository">The repository to configure.</param> @@ -290,7 +290,7 @@ namespace log4net.Config #if (!NETCF && !SSCLI) /// <summary> - /// Configures log4net using the file specified, monitors the file for changes + /// Configures log4net using the file specified, monitors the file for changes /// and reloads the configuration if a change is detected. /// </summary> /// <param name="configFile">The XML file to load the configuration from.</param> @@ -320,8 +320,8 @@ namespace log4net.Config } /// <summary> - /// Configures the <see cref="ILoggerRepository"/> using the file specified, - /// monitors the file for changes and reloads the configuration if a change + /// Configures the <see cref="ILoggerRepository"/> using the file specified, + /// monitors the file for changes and reloads the configuration if a change /// is detected. /// </summary> /// <param name="repository">The repository to configure.</param> http://git-wip-us.apache.org/repos/asf/logging-log4net/blob/8a5b4204/src/Config/DOMConfiguratorAttribute.cs ---------------------------------------------------------------------- diff --git a/src/Config/DOMConfiguratorAttribute.cs b/src/Config/DOMConfiguratorAttribute.cs index e996b0e..880646a 100644 --- a/src/Config/DOMConfiguratorAttribute.cs +++ b/src/Config/DOMConfiguratorAttribute.cs @@ -1,10 +1,10 @@ #region Apache License // -// Licensed to the Apache Software Foundation (ASF) under one or more +// Licensed to the Apache Software Foundation (ASF) under one or more // contributor license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright ownership. +// this work for additional information regarding copyright ownership. // The ASF licenses this file to you under the Apache License, Version 2.0 -// (the "License"); you may not use this file except in compliance with +// (the "License"); you may not use this file except in compliance with // the License. You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 http://git-wip-us.apache.org/repos/asf/logging-log4net/blob/8a5b4204/src/Config/DomainAttribute.cs ---------------------------------------------------------------------- diff --git a/src/Config/DomainAttribute.cs b/src/Config/DomainAttribute.cs index 8e49ff7..19b8b9a 100644 --- a/src/Config/DomainAttribute.cs +++ b/src/Config/DomainAttribute.cs @@ -1,10 +1,10 @@ #region Apache License // -// Licensed to the Apache Software Foundation (ASF) under one or more +// Licensed to the Apache Software Foundation (ASF) under one or more // contributor license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright ownership. +// this work for additional information regarding copyright ownership. // The ASF licenses this file to you under the Apache License, Version 2.0 -// (the "License"); you may not use this file except in compliance with +// (the "License"); you may not use this file except in compliance with // the License. You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 @@ -36,7 +36,7 @@ namespace log4net.Config /// logging repository. This attribute specified on the assembly controls /// the configuration of the domain. The <see cref="RepositoryAttribute.Name"/> property specifies the name /// of the domain that this assembly is a part of. The <see cref="RepositoryAttribute.RepositoryType"/> - /// specifies the type of the repository objects to create for the domain. If + /// specifies the type of the repository objects to create for the domain. If /// this attribute is not specified and a <see cref="RepositoryAttribute.Name"/> is not specified /// then the assembly will be part of the default shared logging domain. /// </para> @@ -67,7 +67,7 @@ namespace log4net.Config } /// <summary> - /// Initialize a new instance of the <see cref="DomainAttribute" /> class + /// Initialize a new instance of the <see cref="DomainAttribute" /> class /// with the name of the domain. /// </summary> /// <param name="name">The name of the domain.</param> http://git-wip-us.apache.org/repos/asf/logging-log4net/blob/8a5b4204/src/Config/Log4NetConfigurationSectionHandler.cs ---------------------------------------------------------------------- diff --git a/src/Config/Log4NetConfigurationSectionHandler.cs b/src/Config/Log4NetConfigurationSectionHandler.cs index cc0bfee..6e9b0b7 100644 --- a/src/Config/Log4NetConfigurationSectionHandler.cs +++ b/src/Config/Log4NetConfigurationSectionHandler.cs @@ -1,10 +1,10 @@ #region Apache License // -// Licensed to the Apache Software Foundation (ASF) under one or more +// Licensed to the Apache Software Foundation (ASF) under one or more // contributor license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright ownership. +// this work for additional information regarding copyright ownership. // The ASF licenses this file to you under the Apache License, Version 2.0 -// (the "License"); you may not use this file except in compliance with +// (the "License"); you may not use this file except in compliance with // the License. You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 http://git-wip-us.apache.org/repos/asf/logging-log4net/blob/8a5b4204/src/Config/PluginAttribute.cs ---------------------------------------------------------------------- diff --git a/src/Config/PluginAttribute.cs b/src/Config/PluginAttribute.cs index eb91906..9f8455c 100644 --- a/src/Config/PluginAttribute.cs +++ b/src/Config/PluginAttribute.cs @@ -1,10 +1,10 @@ #region Apache License // -// Licensed to the Apache Software Foundation (ASF) under one or more +// Licensed to the Apache Software Foundation (ASF) under one or more // contributor license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright ownership. +// this work for additional information regarding copyright ownership. // The ASF licenses this file to you under the Apache License, Version 2.0 -// (the "License"); you may not use this file except in compliance with +// (the "License"); you may not use this file except in compliance with // the License. You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 @@ -31,7 +31,7 @@ using log4net.Plugin; namespace log4net.Config { /// <summary> - /// Assembly level attribute that specifies a plugin to attach to + /// Assembly level attribute that specifies a plugin to attach to /// the repository. /// </summary> /// <remarks> @@ -134,7 +134,7 @@ namespace log4net.Config /// </summary> /// <remarks> /// <para> - /// Creates the instance of the <see cref="IPlugin"/> object as + /// Creates the instance of the <see cref="IPlugin"/> object as /// specified by this attribute. /// </para> /// </remarks> @@ -170,7 +170,7 @@ namespace log4net.Config /// </summary> /// <remarks> /// <para> - /// Overrides base class <see cref="M:Object.ToString()" /> method to + /// Overrides base class <see cref="M:Object.ToString()" /> method to /// return a representation of the properties of this object. /// </para> /// </remarks> http://git-wip-us.apache.org/repos/asf/logging-log4net/blob/8a5b4204/src/Config/RepositoryAttribute.cs ---------------------------------------------------------------------- diff --git a/src/Config/RepositoryAttribute.cs b/src/Config/RepositoryAttribute.cs index 56dd982..7ebe567 100644 --- a/src/Config/RepositoryAttribute.cs +++ b/src/Config/RepositoryAttribute.cs @@ -1,10 +1,10 @@ #region Apache License // -// Licensed to the Apache Software Foundation (ASF) under one or more +// Licensed to the Apache Software Foundation (ASF) under one or more // contributor license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright ownership. +// this work for additional information regarding copyright ownership. // The ASF licenses this file to you under the Apache License, Version 2.0 -// (the "License"); you may not use this file except in compliance with +// (the "License"); you may not use this file except in compliance with // the License. You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 @@ -29,12 +29,12 @@ namespace log4net.Config /// </summary> /// <remarks> /// <para> - /// Assemblies are mapped to logging repository. This attribute specified + /// Assemblies are mapped to logging repository. This attribute specified /// on the assembly controls /// the configuration of the repository. The <see cref="Name"/> property specifies the name /// of the repository that this assembly is a part of. The <see cref="RepositoryType"/> - /// specifies the type of the <see cref="log4net.Repository.ILoggerRepository"/> object - /// to create for the assembly. If this attribute is not specified or a <see cref="Name"/> + /// specifies the type of the <see cref="log4net.Repository.ILoggerRepository"/> object + /// to create for the assembly. If this attribute is not specified or a <see cref="Name"/> /// is not specified then the assembly will be part of the default shared logging repository. /// </para> /// <para> @@ -50,7 +50,7 @@ namespace log4net.Config { // // Class is not sealed because DomainAttribute extends it while it is obsoleted - // + // #region Public Instance Constructors @@ -67,7 +67,7 @@ namespace log4net.Config } /// <summary> - /// Initialize a new instance of the <see cref="RepositoryAttribute" /> class + /// Initialize a new instance of the <see cref="RepositoryAttribute" /> class /// with the name of the repository. /// </summary> /// <param name="name">The name of the repository.</param> @@ -117,10 +117,10 @@ namespace log4net.Config /// interface. /// </para> /// <para> - /// This will be the type of repository created when + /// This will be the type of repository created when /// the repository is created. If multiple assemblies reference the /// same repository then the repository is only created once using the - /// <see cref="RepositoryType" /> of the first assembly to call into the + /// <see cref="RepositoryType" /> of the first assembly to call into the /// repository. /// </para> /// </remarks> http://git-wip-us.apache.org/repos/asf/logging-log4net/blob/8a5b4204/src/Config/SecurityContextProviderAttribute.cs ---------------------------------------------------------------------- diff --git a/src/Config/SecurityContextProviderAttribute.cs b/src/Config/SecurityContextProviderAttribute.cs index c6f8557..4b92a00 100644 --- a/src/Config/SecurityContextProviderAttribute.cs +++ b/src/Config/SecurityContextProviderAttribute.cs @@ -1,10 +1,10 @@ #region Apache License // -// Licensed to the Apache Software Foundation (ASF) under one or more +// Licensed to the Apache Software Foundation (ASF) under one or more // contributor license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright ownership. +// this work for additional information regarding copyright ownership. // The ASF licenses this file to you under the Apache License, Version 2.0 -// (the "License"); you may not use this file except in compliance with +// (the "License"); you may not use this file except in compliance with // the License. You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 http://git-wip-us.apache.org/repos/asf/logging-log4net/blob/8a5b4204/src/Config/XmlConfigurator.cs ---------------------------------------------------------------------- diff --git a/src/Config/XmlConfigurator.cs b/src/Config/XmlConfigurator.cs index 5b11d98..2374b40 100644 --- a/src/Config/XmlConfigurator.cs +++ b/src/Config/XmlConfigurator.cs @@ -1,10 +1,10 @@ #region Apache License // -// Licensed to the Apache Software Foundation (ASF) under one or more +// Licensed to the Apache Software Foundation (ASF) under one or more // contributor license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright ownership. +// this work for additional information regarding copyright ownership. // The ASF licenses this file to you under the Apache License, Version 2.0 -// (the "License"); you may not use this file except in compliance with +// (the "License"); you may not use this file except in compliance with // the License. You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 @@ -48,8 +48,8 @@ namespace log4net.Config /// <summary> /// Private constructor /// </summary> - private XmlConfigurator() - { + private XmlConfigurator() + { } #endregion Protected Instance Constructors @@ -70,7 +70,7 @@ namespace log4net.Config /// <c>log4net</c> that contains the configuration data. /// </para> /// <para> - /// To use this method to configure log4net you must specify + /// To use this method to configure log4net you must specify /// the <see cref="Log4NetConfigurationSectionHandler"/> section /// handler for the <c>log4net</c> configuration section. See the /// <see cref="Log4NetConfigurationSectionHandler"/> for an example. @@ -107,7 +107,7 @@ namespace log4net.Config return configurationMessages; } - static private void InternalConfigure(ILoggerRepository repository) + static private void InternalConfigure(ILoggerRepository repository) { LogLog.Debug(declaringType, "configuring repository [" + repository.Name + "] using .config file section"); @@ -164,7 +164,7 @@ namespace log4net.Config #if !NETSTANDARD1_3 // Excluded because GetCallingAssembly() is not available in CoreFX (https://github.com/dotnet/corefx/issues/2221). #if !NETCF /// <summary> - /// Automatically configures the log4net system based on the + /// Automatically configures the log4net system based on the /// application's configuration settings. /// </summary> /// <remarks> @@ -176,7 +176,7 @@ namespace log4net.Config /// <c>log4net</c> that contains the configuration data. /// </para> /// <para> - /// To use this method to configure log4net you must specify + /// To use this method to configure log4net you must specify /// the <see cref="Log4NetConfigurationSectionHandler"/> section /// handler for the <c>log4net</c> configuration section. See the /// <see cref="Log4NetConfigurationSectionHandler"/> for an example. @@ -185,7 +185,7 @@ namespace log4net.Config /// <seealso cref="Log4NetConfigurationSectionHandler"/> #else /// <summary> - /// Automatically configures the log4net system based on the + /// Automatically configures the log4net system based on the /// application's configuration settings. /// </summary> /// <remarks> @@ -213,7 +213,7 @@ namespace log4net.Config /// </para> /// </remarks> /// <param name="element">The element to parse.</param> - static public ICollection Configure(XmlElement element) + static public ICollection Configure(XmlElement element) { ArrayList configurationMessages = new ArrayList(); @@ -246,9 +246,9 @@ namespace log4net.Config /// normal application on <c>Web.config</c> for an ASP.NET application). /// </para> /// <para> - /// The first element matching <c><configuration></c> will be read as the - /// configuration. If this file is also a .NET .config file then you must specify - /// a configuration section for the <c>log4net</c> element otherwise .NET will + /// The first element matching <c><configuration></c> will be read as the + /// configuration. If this file is also a .NET .config file then you must specify + /// a configuration section for the <c>log4net</c> element otherwise .NET will /// complain. Set the type for the section handler to <see cref="System.Configuration.IgnoreSectionHandler"/>, for example: /// <code lang="XML" escaped="true"> /// <configSections> @@ -257,16 +257,16 @@ namespace log4net.Config /// </code> /// </para> /// <example> - /// The following example configures log4net using a configuration file, of which the + /// The following example configures log4net using a configuration file, of which the /// location is stored in the application's configuration file : /// </example> /// <code lang="C#"> /// using log4net.Config; /// using System.IO; /// using System.Configuration; - /// + /// /// ... - /// + /// /// XmlConfigurator.Configure(new FileInfo(ConfigurationSettings.AppSettings["log4net-config-file"])); /// </code> /// <para> @@ -292,16 +292,16 @@ namespace log4net.Config /// the log4net configuration data. /// </para> /// <example> - /// The following example configures log4net using a configuration file, of which the + /// The following example configures log4net using a configuration file, of which the /// location is stored in the application's configuration file : /// </example> /// <code lang="C#"> /// using log4net.Config; /// using System.IO; /// using System.Configuration; - /// + /// /// ... - /// + /// /// XmlConfigurator.Configure(new FileInfo(ConfigurationSettings.AppSettings["log4net-config-file"])); /// </code> /// <para> @@ -388,7 +388,7 @@ namespace log4net.Config #endif // !NETSTANDARD1_3 /// <summary> - /// Configures the <see cref="ILoggerRepository"/> using the specified XML + /// Configures the <see cref="ILoggerRepository"/> using the specified XML /// element. /// </summary> /// <remarks> @@ -415,7 +415,7 @@ namespace log4net.Config #if !NETCF /// <summary> - /// Configures the <see cref="ILoggerRepository"/> using the specified configuration + /// Configures the <see cref="ILoggerRepository"/> using the specified configuration /// file. /// </summary> /// <param name="repository">The repository to configure.</param> @@ -432,9 +432,9 @@ namespace log4net.Config /// normal application on <c>Web.config</c> for an ASP.NET application). /// </para> /// <para> - /// The first element matching <c><configuration></c> will be read as the - /// configuration. If this file is also a .NET .config file then you must specify - /// a configuration section for the <c>log4net</c> element otherwise .NET will + /// The first element matching <c><configuration></c> will be read as the + /// configuration. If this file is also a .NET .config file then you must specify + /// a configuration section for the <c>log4net</c> element otherwise .NET will /// complain. Set the type for the section handler to <see cref="System.Configuration.IgnoreSectionHandler"/>, for example: /// <code lang="XML" escaped="true"> /// <configSections> @@ -443,16 +443,16 @@ namespace log4net.Config /// </code> /// </para> /// <example> - /// The following example configures log4net using a configuration file, of which the + /// The following example configures log4net using a configuration file, of which the /// location is stored in the application's configuration file : /// </example> /// <code lang="C#"> /// using log4net.Config; /// using System.IO; /// using System.Configuration; - /// + /// /// ... - /// + /// /// XmlConfigurator.Configure(new FileInfo(ConfigurationSettings.AppSettings["log4net-config-file"])); /// </code> /// <para> @@ -468,7 +468,7 @@ namespace log4net.Config /// </remarks> #else /// <summary> - /// Configures the <see cref="ILoggerRepository"/> using the specified configuration + /// Configures the <see cref="ILoggerRepository"/> using the specified configuration /// file. /// </summary> /// <param name="repository">The repository to configure.</param> @@ -480,16 +480,16 @@ namespace log4net.Config /// the configuration data. /// </para> /// <example> - /// The following example configures log4net using a configuration file, of which the + /// The following example configures log4net using a configuration file, of which the /// location is stored in the application's configuration file : /// </example> /// <code lang="C#"> /// using log4net.Config; /// using System.IO; /// using System.Configuration; - /// + /// /// ... - /// + /// /// XmlConfigurator.Configure(new FileInfo(ConfigurationSettings.AppSettings["log4net-config-file"])); /// </code> /// <para> @@ -517,7 +517,7 @@ namespace log4net.Config return configurationMessages; } - + static private void InternalConfigure(ILoggerRepository repository, FileInfo configFile) { LogLog.Debug(declaringType, "configuring repository [" + repository.Name + "] using file [" + configFile + "]"); @@ -534,7 +534,7 @@ namespace log4net.Config { // Open the file for reading FileStream fs = null; - + // Try hard to open the file for(int retry = 5; --retry >= 0; ) { @@ -578,7 +578,7 @@ namespace log4net.Config } /// <summary> - /// Configures the <see cref="ILoggerRepository"/> using the specified configuration + /// Configures the <see cref="ILoggerRepository"/> using the specified configuration /// URI. /// </summary> /// <param name="repository">The repository to configure.</param> @@ -606,7 +606,7 @@ namespace log4net.Config return configurationMessages; } - + static private void InternalConfigure(ILoggerRepository repository, Uri configUri) { LogLog.Debug(declaringType, "configuring repository [" + repository.Name + "] using URI ["+configUri+"]"); @@ -682,7 +682,7 @@ namespace log4net.Config } /// <summary> - /// Configures the <see cref="ILoggerRepository"/> using the specified configuration + /// Configures the <see cref="ILoggerRepository"/> using the specified configuration /// file. /// </summary> /// <param name="repository">The repository to configure.</param> @@ -710,7 +710,7 @@ namespace log4net.Config return configurationMessages; } - + static private void InternalConfigure(ILoggerRepository repository, Stream configStream) { LogLog.Debug(declaringType, "configuring repository [" + repository.Name + "] using stream"); @@ -752,7 +752,7 @@ namespace log4net.Config xmlReader.ValidationType = ValidationType.None; xmlReader.EntityHandling = EntityHandling.ExpandEntities; #endif - + // load the data into the document doc.Load(xmlReader); } @@ -793,7 +793,7 @@ namespace log4net.Config #if (!NETCF && !SSCLI) #if !NETSTANDARD1_3 // Excluded because GetCallingAssembly() is not available in CoreFX (https://github.com/dotnet/corefx/issues/2221). /// <summary> - /// Configures log4net using the file specified, monitors the file for changes + /// Configures log4net using the file specified, monitors the file for changes /// and reloads the configuration if a change is detected. /// </summary> /// <param name="configFile">The XML file to load the configuration from.</param> @@ -831,8 +831,8 @@ namespace log4net.Config #endif // !NETSTANDARD1_3 /// <summary> - /// Configures the <see cref="ILoggerRepository"/> using the file specified, - /// monitors the file for changes and reloads the configuration if a change + /// Configures the <see cref="ILoggerRepository"/> using the file specified, + /// monitors the file for changes and reloads the configuration if a change /// is detected. /// </summary> /// <param name="repository">The repository to configure.</param> @@ -866,7 +866,7 @@ namespace log4net.Config return configurationMessages; } - + static private void InternalConfigureAndWatch(ILoggerRepository repository, FileInfo configFile) { LogLog.Debug(declaringType, "configuring repository [" + repository.Name + "] using file [" + configFile + "] watching for file updates"); @@ -1076,11 +1076,11 @@ namespace log4net.Config /// supplied as <paramref name="element"/>. /// </para> /// <para> - /// This method is ultimately called by one of the Configure methods + /// This method is ultimately called by one of the Configure methods /// to load the configuration from an <see cref="XmlElement"/>. /// </para> /// </remarks> - static private void InternalConfigureFromXml(ILoggerRepository repository, XmlElement element) + static private void InternalConfigureFromXml(ILoggerRepository repository, XmlElement element) { if (element == null) { @@ -1109,7 +1109,7 @@ namespace log4net.Config // Pass the configurator the config element configurableRepository.Configure(newElement); - } + } } } @@ -1119,7 +1119,7 @@ namespace log4net.Config /// <summary> /// Maps repository names to ConfigAndWatchHandler instances to allow a particular - /// ConfigAndWatchHandler to dispose of its FileSystemWatcher when a repository is + /// ConfigAndWatchHandler to dispose of its FileSystemWatcher when a repository is /// reconfigured. /// </summary> private readonly static Hashtable m_repositoryName2ConfigAndWatchHandler = new Hashtable(); http://git-wip-us.apache.org/repos/asf/logging-log4net/blob/8a5b4204/src/Config/XmlConfiguratorAttribute.cs ---------------------------------------------------------------------- diff --git a/src/Config/XmlConfiguratorAttribute.cs b/src/Config/XmlConfiguratorAttribute.cs index 6c3ea3e..3ea1bdd 100644 --- a/src/Config/XmlConfiguratorAttribute.cs +++ b/src/Config/XmlConfiguratorAttribute.cs @@ -1,10 +1,10 @@ #region Apache License // -// Licensed to the Apache Software Foundation (ASF) under one or more +// Licensed to the Apache Software Foundation (ASF) under one or more // contributor license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright ownership. +// this work for additional information regarding copyright ownership. // The ASF licenses this file to you under the Apache License, Version 2.0 -// (the "License"); you may not use this file except in compliance with +// (the "License"); you may not use this file except in compliance with // the License. You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 @@ -54,7 +54,7 @@ namespace log4net.Config /// The <see cref="ConfigFileExtension"/> property is used as a postfix to the assembly file name. /// The config file must be located in the application's base directory; <see cref="AppDomain.BaseDirectory"/>. /// For example in a console application setting the <see cref="ConfigFileExtension"/> to - /// <c>config</c> has the same effect as not specifying the <see cref="ConfigFile"/> or + /// <c>config</c> has the same effect as not specifying the <see cref="ConfigFile"/> or /// <see cref="ConfigFileExtension"/> properties. /// </para> /// <para> @@ -64,13 +64,13 @@ namespace log4net.Config /// <note> /// <para> /// Log4net will only look for assembly level configuration attributes once. - /// When using the log4net assembly level attributes to control the configuration - /// of log4net you must ensure that the first call to any of the + /// When using the log4net assembly level attributes to control the configuration + /// of log4net you must ensure that the first call to any of the /// <see cref="log4net.Core.LoggerManager"/> methods is made from the assembly with the configuration - /// attributes. + /// attributes. /// </para> /// <para> - /// If you cannot guarantee the order in which log4net calls will be made from + /// If you cannot guarantee the order in which log4net calls will be made from /// different assemblies you must use programmatic configuration instead, i.e. /// call the <see cref="M:XmlConfigurator.Configure()"/> method directly. /// </para> @@ -84,7 +84,7 @@ namespace log4net.Config { // // Class is not sealed because DOMConfiguratorAttribute extends it while it is obsoleted - // + // /// <summary> /// Default constructor @@ -131,7 +131,7 @@ namespace log4net.Config /// <remarks> /// <para> /// If specified this is the extension for the configuration file. - /// The path to the config file is built by using the <b>application + /// The path to the config file is built by using the <b>application /// base</b> directory (<see cref="AppDomain.BaseDirectory"/>), /// the <b>assembly file name</b> and the config file extension. /// </para> @@ -159,7 +159,7 @@ namespace log4net.Config /// <remarks> /// <para> /// If this flag is specified and set to <c>true</c> then the framework - /// will watch the configuration file and will reload the config each time + /// will watch the configuration file and will reload the config each time /// the file is modified. /// </para> /// <para> @@ -237,7 +237,7 @@ namespace log4net.Config { // Work out the full path to the config file string fullPath2ConfigFile = null; - + // Select the config file if (m_configFile == null || m_configFile.Length == 0) { @@ -341,7 +341,7 @@ namespace log4net.Config { // Work out the full path to the config file Uri fullPath2ConfigFile = null; - + // Select the config file if (m_configFile == null || m_configFile.Length == 0) { http://git-wip-us.apache.org/repos/asf/logging-log4net/blob/8a5b4204/src/Core/CompactRepositorySelector.cs ---------------------------------------------------------------------- diff --git a/src/Core/CompactRepositorySelector.cs b/src/Core/CompactRepositorySelector.cs index dd46f6d..4b79269 100644 --- a/src/Core/CompactRepositorySelector.cs +++ b/src/Core/CompactRepositorySelector.cs @@ -1,10 +1,10 @@ #region Apache License // -// Licensed to the Apache Software Foundation (ASF) under one or more +// Licensed to the Apache Software Foundation (ASF) under one or more // contributor license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright ownership. +// this work for additional information regarding copyright ownership. // The ASF licenses this file to you under the Apache License, Version 2.0 -// (the "License"); you may not use this file except in compliance with +// (the "License"); you may not use this file except in compliance with // the License. You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 @@ -103,10 +103,10 @@ namespace log4net.Core /// <remarks> /// <para> /// The <paramref name="assembly"/> argument is not used. This selector does not create a - /// separate repository for each assembly. + /// separate repository for each assembly. /// </para> /// <para> - /// As a named repository is not specified the default repository is + /// As a named repository is not specified the default repository is /// returned. The default repository is named <c>log4net-default-repository</c>. /// </para> /// </remarks> @@ -122,8 +122,8 @@ namespace log4net.Core /// <returns>The named <see cref="ILoggerRepository"/></returns> /// <remarks> /// <para> - /// Get the named <see cref="ILoggerRepository"/>. The default - /// repository is <c>log4net-default-repository</c>. Other repositories + /// Get the named <see cref="ILoggerRepository"/>. The default + /// repository is <c>log4net-default-repository</c>. Other repositories /// must be created using the <see cref="M:CreateRepository(string, Type)"/>. /// If the named repository does not exist an exception is thrown. /// </para> @@ -150,7 +150,7 @@ namespace log4net.Core } /// <summary> - /// Create a new repository for the assembly specified + /// Create a new repository for the assembly specified /// </summary> /// <param name="assembly">not used</param> /// <param name="repositoryType">the type of repository to create, must implement <see cref="ILoggerRepository"/></param> @@ -158,14 +158,14 @@ namespace log4net.Core /// <remarks> /// <para> /// The <paramref name="assembly"/> argument is not used. This selector does not create a - /// separate repository for each assembly. + /// separate repository for each assembly. /// </para> /// <para> /// If the <paramref name="repositoryType"/> is <c>null</c> then the /// default repository type specified to the constructor is used. /// </para> /// <para> - /// As a named repository is not specified the default repository is + /// As a named repository is not specified the default repository is /// returned. The default repository is named <c>log4net-default-repository</c>. /// </para> /// </remarks> @@ -190,7 +190,7 @@ namespace log4net.Core } return rep; - } + } } /// <summary> @@ -210,7 +210,7 @@ namespace log4net.Core /// If the named repository already exists an exception will be thrown. /// </para> /// <para> - /// If <paramref name="repositoryType"/> is <c>null</c> then the default + /// If <paramref name="repositoryType"/> is <c>null</c> then the default /// repository type specified to the constructor is used. /// </para> /// </remarks> @@ -268,7 +268,7 @@ namespace log4net.Core /// <remarks> /// <para> /// Test if a named repository exists. Use <see cref="M:CreateRepository(string, Type)"/> - /// to create a new repository and <see cref="M:GetRepository(string)"/> to retrieve + /// to create a new repository and <see cref="M:GetRepository(string)"/> to retrieve /// a repository. /// </para> /// </remarks>