h e l p   a l l 
 
 
 
 - - - - - - - -   C o n s o l e   k e y s   - - - - - - - - 
 
 E n t e r     -     e x e c u t e s   e n t e r e d   c o m m a n d 
 
 S h i f t + E n t e r     -     n e w   l i n e 
 
 T a b     -     a u t o - c o m p l e t e s   c u r r e n t   c o m m a n d / l o o k s   t h r o u g h   t h e   c o m m a n d s   h i s t o r y 
 
 S h i f t + T a b     -     t h e   s a m e   a s   T a b   b u t   b a c k w a r d s 
 
 A r r o w   U p     -     p r e v i o u s   c o m m a n d   ( w h e n   C o n s o l e   C o m m a n d s   H i s t o r y   i s   e n a b l e d ) 
 
 A r r o w   D o w n     -     n e x t   c o m m a n d   ( w h e n   C o n s o l e   C o m m a n d s   H i s t o r y   i s   e n a b l e d ) 
 
 C t r l + C     -     c o p y   s e l e c t e d   t e x t   t o   t h e   c l i p b o a r d 
 
 C t r l + V     -     p a s t e   f r o m   t h e   c l i p b o a r d 
 
 C t r l + W     -     w o r d   w r a p   o n / o f f 
 
 C t r l + ~     -     t o g g l e   C o n s o l e / e d i t i n g   w i n d o w 
 
 C t r l + T     -     h i d e   t o g g l e d   C o n s o l e   o n / o f f 
 
 C t r l + F ,   F 3 ,   F 7     -     s h o w s   C o n s o l e ' s   F i n d   d i a l o g 
 
 E s c     -     h i d e s   C o n s o l e ' s   F i n d   d i a l o g 
 
 E n t e r ,   F 3   ( i n   C o n s o l e ' s   F i n d   d i a l o g )     -     f i n d   n e x t   ( d o w n ) 
 
 S h i f t + E n t e r ,   S h i f t + F 3   ( i n   C o n s o l e ' s   F i n d   d i a l o g )     -     f i n d   p r e v i o u s   ( u p ) 
 
 - - - - - - - -   C o n s o l e   c o m m a n d s   - - - - - - - - 
 
 h e l p     -     s h o w   a v a i l a b l e   c o m m a n d s 
 
 h e l p   < c o m m a n d >     -     s h o w   d e t a i l e d   i n f o r m a t i o n   a b o u t   s p e c i f i e d   c o m m a n d 
 
 h e l p   a l l     -     s h o w   a l l   a v a i l a b l e   h e l p   ( a l l   t h e   c o m m a n d s   i n   d e t a i l ) 
 
 v e r     -     s h o w   p l u g i n ' s   v e r s i o n 
 
 m a n u a l     -     s h o w   N p p E x e c   U s e r   G u i d e 
 
 a b o u t     -   s h o w   N p p E x e c   H e l p / A b o u t 
 
 n p p e x e c :     -     p r e f i x   f o r   N p p E x e c ' s   c o m m a n d s   ( e . g .   " n p p e x e c : n p p _ c o n s o l e   o f f " ) 
 
 n p p e x e c : :     -     a l w a y s   e x e c u t e s   a   c o m m a n d   i n   a   c o l l a t e r a l   ( p a r a l l e l )   s c r i p t 
 
 C T R L + C     -     k i l l   ( v i a   C t r l + C )   o r   t e r m i n a t e   c u r r e n t   c h i l d   p r o c e s s 
 
 C T R L + B R E A K     -     k i l l   ( v i a   C t r l + B r e a k )   o r   t e r m i n a t e   c u r r e n t   c h i l d   p r o c e s s 
 
 C T R L + B R E A K     -     a b o r t   c u r r e n t   N p p E x e c ' s   s c r i p t   ( w i t h o u t   c l o s i n g   t h e   C o n s o l e ) 
 
 C T R L + Z     -     s e n d   ^ Z   t o   c u r r e n t   c h i l d   p r o c e s s 
 
 - - - - - - - -   G e n e r a l   c o m m a n d s   - - - - - - - - 
 
 c l s     -     c l e a r   C o n s o l e   s c r e e n 
 
 c d     -     s h o w s   c u r r e n t   p a t h 
 
 c d   < a b s o l u t e _ p a t h   o r   r e l a t i v e _ p a t h >     -     c h a n g e s   c u r r e n t   p a t h 
 
 d i r     -     l i s t s   f i l e s   a n d   s u b d i r s 
 
 d i r   < m a s k   o r   p a t h \ m a s k >     -     l i s t s   f i l e s / s u b d i r s   m a t c h e d   t h e   m a s k 
 
 e c h o   < t e x t >     -     p r i n t s   a   t e x t   i n   t h e   C o n s o l e 
 
 i f   < c o n d i t i o n >   g o t o   < l a b e l >     -     j u m p s   t o   t h e   l a b e l   i f   t h e   c o n d i t i o n   i s   t r u e 
 
 i f ~   < c o n d i t i o n >   g o t o   < l a b e l >     -     c a l c u l a t e s   a n d   c h e c k s   t h e   c o n d i t i o n 
 
 i f   . . .   e l s e   i f   . . .   e l s e   . . .   e n d i f     -     c o n d i t i o n a l   e x e c u t i o n 
 
 i f ~   . . .   e l s e   i f ~   . . .   e l s e   . . .   e n d i f     -     c o n d i t i o n a l   e x e c u t i o n 
 
 g o t o   < l a b e l >     -     j u m p s   t o   t h e   l a b e l 
 
 e x i t     -     e x i t s   t h e   c u r r e n t   N p p E x e c ' s   s c r i p t 
 
 e x i t   < t y p e >     -     e x i t s   t h e   N p p E x e c ' s   s c r i p t 
 
 s e t     -     s h o w s   a l l   u s e r ' s   v a r i a b l e s 
 
 s e t   < v a r >     -     s h o w s   t h e   v a l u e   o f   u s e r ' s   v a r i a b l e   < v a r > 
 
 s e t   < v a r >   =   < v a l u e >     -     s e t s   t h e   v a l u e   o f   u s e r ' s   v a r i a b l e   < v a r > 
 
 s e t   < v a r >   ~   < m a t h   e x p r e s s i o n >     -     c a l c u l a t e s   t h e   m a t h   e x p r e s s i o n 
 
 s e t   < v a r >   ~   s t r l e n   < s t r i n g >     -     c a l c u l a t e s   t h e   s t r i n g   l e n g t h 
 
 s e t   < v a r >   ~   s t r l e n u t f 8   < s t r i n g >     -     c a l c u l a t e s   t h e   U T F - 8   s t r i n g   l e n g t h 
 
 s e t   < v a r >   ~   s t r l e n u   < s t r i n g >     -     t h e   s a m e   a s   s t r l e n u t f 8 
 
 s e t   < v a r >   ~   s t r l e n s c i   < s t r i n g >     -     s t r i n g   l e n g t h ,   u s i n g   S c i n t i l l a ' s   e n c o d i n g 
 
 s e t   < v a r >   ~   s t r l e n s   < s t r i n g >     -     t h e   s a m e   a s   s t r l e n s c i 
 
 s e t   < v a r >   ~   s t r u p p e r   < s t r i n g >     -     r e t u r n s   t h e   s t r i n g   i n   u p p e r   c a s e 
 
 s e t   < v a r >   ~   s t r l o w e r   < s t r i n g >     -     r e t u r n s   t h e   s t r i n g   i n   l o w e r   c a s e 
 
 s e t   < v a r >   ~   s u b s t r   < p o s >   < l e n >   < s t r i n g >     -     r e t u r n s   t h e   s u b s t r i n g 
 
 s e t   < v a r >   ~   s t r f i n d   < s >   < t >     -     r e t u r n s   t h e   f i r s t   p o s i t i o n   o f   < t >   i n   < s > 
 
 s e t   < v a r >   ~   s t r r f i n d   < s >   < t >     -     r e t u r n s   t h e   l a s t   p o s i t i o n   o f   < t >   i n   < s > 
 
 s e t   < v a r >   ~   s t r r e p l a c e   < s >   < t 0 >   < t 1 >     -     r e p l a c e s   a l l   < t 0 >   w i t h   < t 1 > 
 
 s e t   < v a r >   ~   s t r q u o t e   < s >     -     s u r r o u n d s   < s >   w i t h   " "   q u o t e s 
 
 s e t   < v a r >   ~   s t r u n q u o t e   < s >     -     r e m o v e s   t h e   s u r r o u n d i n g   " "   q u o t e s 
 
 s e t   < v a r >   ~   s t r e s c a p e   < s >     -     s i m p l e   c h a r a c t e r   e s c a p i n g   ( e . g .   < T A B >   t o   ' \ t ' ) 
 
 s e t   < v a r >   ~   s t r u n e s c a p e   < s >     -     s i m p l e   c h a r a c t e r   u n e s c a p i n g   ( e . g .   ' \ n '   t o   < L F > ) 
 
 s e t   < v a r >   ~   s t r e x p a n d   < s >     -     e x p a n d s   a l l   $ ( s u b )   v a l u e s   w i t h i n   < s > 
 
 s e t   < v a r >   ~   n o r m p a t h   < p a t h >     -     r e t u r n s   a   n o r m a l i z e d   p a t h 
 
 s e t   < v a r >   ~   s t r f r o m h e x   < h s >     -     r e t u r n s   a   s t r i n g   f r o m   t h e   h e x - s t r i n g 
 
 s e t   < v a r >   ~   s t r t o h e x   < s >     -     r e t u r n s   a   h e x - s t r i n g   f r o m   t h e   s t r i n g 
 
 s e t   < v a r >   ~   c h r   < n >     -     r e t u r n s   a   c h a r a c t e r   f r o m   a   c h a r a c t e r   c o d e   < n > 
 
 s e t   < v a r >   ~   o r d   < c >     -     r e t u r n s   a   d e c i m a l   c h a r a c t e r   c o d e   o f   a   c h a r a c t e r   < c > 
 
 s e t   < v a r >   ~   o r d x   < c >     -     r e t u r n s   a   h e x a d e c i m a l   c h a r a c t e r   c o d e   o f   a   c h a r a c t e r   < c > 
 
 s e t   l o c a l     -     s h o w s   a l l   u s e r ' s   l o c a l   v a r i a b l e s 
 
 s e t   l o c a l   < v a r >     -     s h o w s   t h e   v a l u e   o f   u s e r ' s   l o c a l   v a r i a b l e   < v a r > 
 
 s e t   l o c a l   < v a r >   =   . . .     -     s e t s   t h e   v a l u e   o f   u s e r ' s   l o c a l   v a r i a b l e   < v a r > 
 
 s e t   l o c a l   < v a r >   ~   . . .     -     c a l c u l a t e s   t h e   v a l u e   o f   u s e r ' s   l o c a l   v a r i a b l e 
 
 u n s e t   < v a r >     -     r e m o v e s   u s e r ' s   v a r i a b l e   < v a r > 
 
 u n s e t   < v a r >   =   < v a l u e >     -     r e m o v e s   u s e r ' s   v a r i a b l e   < v a r > 
 
 u n s e t   l o c a l   < v a r >     -     r e m o v e s   u s e r ' s   l o c a l   v a r i a b l e   < v a r > 
 
 e n v _ s e t   < v a r >     -     s h o w s   t h e   v a l u e   o f   e n v i r o n m e n t   v a r i a b l e   < v a r > 
 
 e n v _ s e t   < v a r >   =   < v a l u e >     -     s e t s   t h e   v a l u e   o f   e n v i r o n m e n t   v a r i a b l e   < v a r > 
 
 e n v _ s e t   l o c a l   . . .     -     s e t s   a n   e n v i r o n m e n t   v a r i a b l e   l o c a l l y   ( w i t h i n   t h e   c u r r e n t   s c r i p t ) 
 
 e n v _ u n s e t   < v a r >     -     r e m o v e s / r e s t o r e s   t h e   e n v i r o n m e n t   v a r i a b l e   < v a r > 
 
 s e t _ e n v   < v a r >   =   < v a l u e >     -     s e e   " e n v _ s e t " 
 
 u n s e t _ e n v   < v a r >     -     s e e   " e n v _ u n s e t " 
 
 i n p u t b o x   " m e s s a g e "     -     s h o w s   I n p u t B o x ,   s e t s   $ ( I N P U T ) 
 
 i n p u t b o x   " m e s s a g e "   :   i n i t i a l _ v a l u e     -     s h o w s   I n p u t B o x ,   s e t s   $ ( I N P U T ) 
 
 i n p u t b o x   " m e s s a g e "   :   " v a l u e _ n a m e "   :   i n i t i a l _ v a l u e     -     I n p u t B o x   c u s t o m i z a t i o n 
 
 i n p u t b o x   " m e s s a g e "   :   " v a l u e _ n a m e "   :   " i n i t i a l _ v a l u e "   :   t i m e _ m s     -     e x p i r a b l e 
 
 m e s s a g e b o x   " t e x t "     -     s h o w s   a   s i m p l e   M e s s a g e B o x 
 
 m e s s a g e b o x   " t e x t "   :   " t i t l e "     -     s h o w s   a   M e s s a g e B o x   w i t h   a   c u s t o m   t i t l e 
 
 m e s s a g e b o x   " t e x t "   :   " t i t l e "   :   t y p e     -     s h o w s   a   M e s s a g e B o x   o f   a   g i v e n   t y p e 
 
 m e s s a g e b o x   " t e x t "   :   " t i t l e "   :   t y p e   :   t i m e o u t     -     e x p i r a b l e   M e s s a g e B o x 
 
 c o n _ c o l o u r   < c o l o u r s >     -     s e t s   t h e   C o n s o l e ' s   c o l o u r s 
 
 c o n _ c o l o u r   l o c a l   . . .     -     s e t s   t h e   c o l o u r s   l o c a l l y   ( w i t h i n   t h e   c u r r e n t   s c r i p t ) 
 
 c o n _ f i l t e r   < f i l t e r s >     -     e n a b l e s / d i s a b l e s   t h e   C o n s o l e ' s   o u t p u t   f i l t e r s 
 
 c o n _ f i l t e r   l o c a l   . . .     -     s e t s   t h e   f i l t e r s   l o c a l l y   ( w i t h i n   t h e   c u r r e n t   s c r i p t ) 
 
 c o n _ l o a d f r o m   < f i l e >     -     l o a d s   a   f i l e ' s   c o n t e n t   t o   t h e   C o n s o l e 
 
 c o n _ l o a d   < f i l e >     -     s e e   " c o n _ l o a d f r o m " 
 
 c o n _ s a v e t o   < f i l e >     -     s a v e s   t h e   C o n s o l e ' s   c o n t e n t   t o   a   f i l e 
 
 c o n _ s a v e   < f i l e >     -     s e e   " c o n _ s a v e t o " 
 
 s e l _ l o a d f r o m   < f i l e >     -     r e p l a c e   c u r r e n t   s e l e c t i o n   w i t h   a   f i l e ' s   c o n t e n t 
 
 s e l _ l o a d   < f i l e >     -     s e e   " s e l _ l o a d f r o m " 
 
 s e l _ s a v e t o   < f i l e >     -     s a v e   t h e   s e l e c t e d   t e x t   t o   a   f i l e 
 
 s e l _ s a v e t o   < f i l e >   :   < e n c o d i n g >     -     s a v e   t h e   s e l e c t e d   t e x t   t o   a   f i l e 
 
 s e l _ s a v e   < f i l e >   :   < e n c o d i n g >     -     s e e   " s e l _ s a v e t o " 
 
 s e l _ s e t t e x t   < t e x t >     -     r e p l a c e   c u r r e n t   s e l e c t i o n   w i t h   t h e   t e x t   s p e c i f i e d 
 
 s e l _ s e t t e x t +   < t e x t >     -     r e p l a c e   c u r r e n t   s e l e c t i o n   w i t h   t h e   t e x t   s p e c i f i e d 
 
 t e x t _ l o a d f r o m   < f i l e >     -     r e p l a c e   t h e   e n t i r e   t e x t   w i t h   a   f i l e ' s   c o n t e n t 
 
 t e x t _ l o a d   < f i l e >     -     s e e   " t e x t _ l o a d f r o m " 
 
 t e x t _ s a v e t o   < f i l e >     -     s a v e   t h e   e n t i r e   t e x t   t o   a   f i l e 
 
 t e x t _ s a v e t o   < f i l e >   :   < e n c o d i n g >     -     s a v e   t h e   e n t i r e   t e x t   t o   a   f i l e 
 
 t e x t _ s a v e   < f i l e >   :   < e n c o d i n g >     -     s e e   " t e x t _ s a v e t o " 
 
 c l i p _ s e t t e x t   < t e x t >     -     s e t   t h e   c l i p b o a r d   t e x t 
 
 n p p _ e x e c   < s c r i p t >     -     e x e c u t e   c o m m a n d s   f r o m   s p e c i f i e d   N p p E x e c ' s   s c r i p t 
 
 n p p _ e x e c   < f i l e >     -     e x e c u t e   c o m m a n d s   f r o m   s p e c i f i e d   N p p E x e c ' s   f i l e 
 
 n p p _ e x e c   < s c r i p t / f i l e >   < a r g s >     -     p a s s e s   a d d i t i o n a l   a r g u m e n t s   < a r g s > 
 
 n p p _ e x e c t e x t   < m o d e >   < t e x t >     -     e x e c u t e   t h e   g i v e n   t e x t 
 
 n p p _ c l o s e     -     c l o s e   c u r r e n t   f i l e   i n   N o t e p a d + + 
 
 n p p _ c l o s e   < f i l e >     -     c l o s e   s p e c i f i e d   f i l e   o p e n e d   i n   N o t e p a d + + 
 
 n p p _ c o n s o l e   < o n / o f f / k e e p >     -     s h o w / h i d e   t h e   C o n s o l e   w i n d o w 
 
 n p p _ c o n s o l e   < e n a b l e / d i s a b l e >     -     e n a b l e s / d i s a b l e s   o u t p u t   t o   t h e   C o n s o l e 
 
 n p p _ c o n s o l e   < 1 / 0 / ? >     -     s h o w / h i d e   t h e   C o n s o l e   w i n d o w 
 
 n p p _ c o n s o l e   < + / - >     -     e n a b l e s / d i s a b l e s   o u t p u t   t o   t h e   C o n s o l e 
 
 n p p _ c o n s o l e   l o c a l   . . .     -     C o n s o l e   o n / o f f   l o c a l l y   ( w i t h i n   t h e   c u r r e n t   s c r i p t ) 
 
 n p p _ m e n u c o m m a n d   < m e n u \ i t e m \ n a m e >     -     e x e c u t e s   ( i n v o k e s )   a   m e n u   i t e m 
 
 n p p _ o p e n   < f i l e >     -     ( r e ) o p e n   s p e c i f i e d   f i l e   i n   N o t e p a d + + 
 
 n p p _ o p e n   < m a s k   o r   p a t h \ m a s k >     -     o p e n s   f i l e ( s )   m a t c h e d   t h e   m a s k 
 
 n p p _ r u n   < c o m m a n d >     -     r u n   e x t e r n a l   p r o c e s s / c o m m a n d 
 
 n p p _ s a v e     -     s a v e   c u r r e n t   f i l e   i n   N o t e p a d + + 
 
 n p p _ s a v e   < f i l e >     -     s a v e   s p e c i f i e d   f i l e   o p e n e d   i n   N o t e p a d + + 
 
 n p p _ s a v e a s   < f i l e >     -     s a v e   c u r r e n t   f i l e   w i t h   a   n e w   ( p a t h ) n a m e 
 
 n p p _ s a v e a l l     -     s a v e   a l l   m o d i f i e d   f i l e s 
 
 n p p _ s w i t c h   < f i l e >     -     s w i t c h   t o   s p e c i f i e d   o p e n e d   f i l e 
 
 n p p _ s e t f o c u s     -     s e t   t h e   k e y b o a r d   f o c u s 
 
 n p p _ s e n d m s g   < m s g >     -     s e n d   a   m e s s a g e   ( m s g )   t o   N o t e p a d + + 
 
 n p p _ s e n d m s g   < m s g >   < w p a r a m >     -     m e s s a g e   w i t h   p a r a m e t e r   ( w p a r a m ) 
 
 n p p _ s e n d m s g   < m s g >   < w p a r a m >   < l p a r a m >     -     m s g   t o   N o t e p a d + + 
 
 n p p _ s e n d m s g e x   < h w n d >   < m s g >   < w p a r a m >   < l p a r a m >     -     m s g   t o   h w n d 
 
 s c i _ s e n d m s g   < m s g >     -     s e n d   a   m e s s a g e   ( m s g )   t o   c u r r e n t   S c i n t i l l a 
 
 s c i _ s e n d m s g   < m s g >   < w p a r a m >     -     m e s s a g e   w i t h   p a r a m e t e r   ( w p a r a m ) 
 
 s c i _ s e n d m s g   < m s g >   < w p a r a m >   < l p a r a m >     -     m s g   t o   S c i n t i l l a 
 
 s c i _ f i n d   < f l a g s >   < f i n d _ w h a t >     -     f i n d   a   s t r i n g 
 
 s c i _ r e p l a c e   < f l a g s >   < f i n d _ w h a t >   < r e p l a c e _ w i t h >     -     r e p l a c e   a   s t r i n g 
 
 p r o c _ i n p u t   < s t r i n g >     -     s e n d   a   s t r i n g   t o   a   c h i l d   p r o c e s s 
 
 p r o c _ s i g n a l   < s i g n a l >     -     s i g n a l   t o   a   c h i l d   p r o c e s s 
 
 s l e e p   < m s >     -     s l e e p   f o r   m s   m i l l i s e c o n d s 
 
 s l e e p   < m s >   < t e x t >     -     p r i n t   t h e   t e x t   a n d   s l e e p   f o r   m s   m i l l i s e c o n d s 
 
 n p e _ c m d a l i a s     -     s h o w   a l l   c o m m a n d   a l i a s e s 
 
 n p e _ c m d a l i a s   < a l i a s >     -     s h o w s   t h e   v a l u e   o f   c o m m a n d   a l i a s 
 
 n p e _ c m d a l i a s   < a l i a s >   =     -     r e m o v e s   t h e   c o m m a n d   a l i a s 
 
 n p e _ c m d a l i a s   < a l i a s >   =   < c o m m a n d >     -     s e t s   t h e   c o m m a n d   a l i a s 
 
 n p e _ c o n s o l e   < o p t i o n s >     -     s e t / m o d i f y   C o n s o l e   o p t i o n s / m o d e 
 
 n p e _ c o n s o l e   l o c a l   . . .     -     s e t s   C o n s o l e ' s   m o d e   l o c a l l y   ( w i t h i n   t h e   c u r r e n t   s c r i p t ) 
 
 n p e _ d e b u g l o g   < o n / o f f >     -     e n a b l e / d i s a b l e   D e b u g   L o g 
 
 n p e _ d e b u g l o g   l o c a l   . . .     -     e n a b l e / d i s a b l e   D e b u g   L o g   l o c a l l y   ( w i t h i n   t h e   c u r r e n t   s c r i p t ) 
 
 n p e _ d e b u g   < 1 / 0 >     -     s e e   " n p e _ d e b u g l o g " 
 
 n p e _ n o e m p t y v a r s   < 1 / 0 >     -     e n a b l e / d i s a b l e   r e p l a c e m e n t   o f   e m p t y   v a r s 
 
 n p e _ n o e m p t y v a r s   l o c a l   . . .     -     s e t s   e m p t y   v a r s   o n / o f f   l o c a l l y   ( w i t h i n   t h e   c u r r e n t   s c r i p t ) 
 
 n p e _ q u e u e   < c o m m a n d >     -     q u e u e   N p p E x e c ' s   c o m m a n d   t o   b e   e x e c u t e d 
 
 n p e _ s e n d m s g b u f l e n   < m a x _ l e n >     -     s e t   n p p / s c i _ s e n d m s g ' s   b u f f e r   l e n g t h 
 
 n p e _ s e n d m s g b u f l e n   l o c a l   . . .     -     s e t s   t h e   b u f f e r   l e n g t h   l o c a l l y   ( w i t h i n   t h e   c u r r e n t   s c r i p t ) 
 
 \ < s c r i p t / f i l e >     -     t h e   s a m e   a s     n p p _ e x e c   < s c r i p t / f i l e > 
 
 \ < s c r i p t / f i l e >   < a r g s >     -     t h e   s a m e   a s     n p p _ e x e c   < s c r i p t / f i l e >   < a r g s > 
 
 n p p e x e c :     -     p r e f i x   f o r   N p p E x e c ' s   c o m m a n d s   ( e . g .   " n p p e x e c : n p p _ c o n s o l e   o f f " ) 
 
 n p p e x e c : :     -     a l w a y s   e x e c u t e s   a   c o m m a n d   i n   a   c o l l a t e r a l   ( p a r a l l e l )   s c r i p t 
 
 - - - - - - - -   E n v i r o n m e n t   v a r i a b l e s   - - - - - - - - 
 
 $ ( F U L L _ C U R R E N T _ P A T H )     :     E : \ m y   W e b \ m a i n \ w e l c o m e . h t m l 
 
 $ ( C U R R E N T _ D I R E C T O R Y )     :     E : \ m y   W e b \ m a i n 
 
 $ ( F I L E _ N A M E )     :     w e l c o m e . h t m l 
 
 $ ( N A M E _ P A R T )     :     w e l c o m e 
 
 $ ( E X T _ P A R T )     :     . h t m l 
 
 $ ( N P P _ D I R E C T O R Y )     :     f u l l   p a t h   o f   d i r e c t o r y   w i t h   n o t e p a d + + . e x e 
 
 $ ( N P P _ F U L L _ F I L E _ P A T H )     :     f u l l   p a t h   t o   n o t e p a d + + . e x e 
 
 $ ( C U R R E N T _ W O R D )     :     w o r d ( s )   y o u   s e l e c t e d   i n   N o t e p a d + + 
 
 $ ( C U R R E N T _ L I N E )     :     c u r r e n t   l i n e   n u m b e r 
 
 $ ( C U R R E N T _ L I N E S T R )     :     t e x t   o f   t h e   c u r r e n t   l i n e 
 
 $ ( C U R R E N T _ C O L U M N )     :     c u r r e n t   c o l u m n   n u m b e r 
 
 $ ( S E L E C T E D _ T E X T )     :     t h e   t e x t   y o u   s e l e c t e d   i n   N o t e p a d + + 
 
 $ ( F I L E _ N A M E _ A T _ C U R S O R )     :     f i l e   n a m e   s e l e c t e d   i n   t h e   e d i t o r 
 
 $ ( W O R K S P A C E _ I T E M _ P A T H )     :     f u l l   p a t h   t o   t h e   c u r r e n t   i t e m   i n   t h e   w o r k s p a c e   p a n e 
 
 $ ( W O R K S P A C E _ I T E M _ D I R )     :     d i r e c t o r y   c o n t a i n i n g   t h e   c u r r e n t   i t e m   i n   t h e   w o r k s p a c e   p a n e 
 
 $ ( W O R K S P A C E _ I T E M _ N A M E )     :     f i l e   n a m e   o f   t h e   c u r r e n t   i t e m   i n   t h e   w o r k s p a c e   p a n e 
 
 $ ( W O R K S P A C E _ I T E M _ R O O T )     :     r o o t   p a t h   o f   t h e   c u r r e n t   i t e m   i n   t h e   w o r k s p a c e   p a n e 
 
 $ ( C L O U D _ L O C A T I O N _ P A T H )     :     c l o u d   l o c a t i o n   p a t h   ( i n   N o t e p a d + + ' s   s e t t i n g s ) 
 
 $ ( C L I P B O A R D _ T E X T )     :     t e x t   f r o m   t h e   c l i p b o a r d 
 
 $ ( # N )     :     f u l l   p a t h   o f   t h e   N t h   o p e n e d   d o c u m e n t   ( N = 1 , 2 , 3 . . . ) 
 
 $ ( # 0 )     :     f u l l   p a t h   t o   n o t e p a d + + . e x e 
 
 $ ( L E F T _ V I E W _ F I L E )     :     c u r r e n t   f i l e   p a t h - n a m e   i n   p r i m a r y   ( l e f t )   v i e w 
 
 $ ( R I G H T _ V I E W _ F I L E )     :     c u r r e n t   f i l e   p a t h - n a m e   i n   s e c o n d a r y   ( r i g h t )   v i e w 
 
 $ ( P L U G I N S _ C O N F I G _ D I R )     :     f u l l   p a t h   o f   t h e   p l u g i n s   c o n f i g u r a t i o n   d i r e c t o r y 
 
 $ ( C W D )     :     c u r r e n t   w o r k i n g   d i r e c t o r y   o f   N p p E x e c   ( u s e   " c d "   t o   c h a n g e   i t ) 
 
 $ ( A R G C )     :     n u m b e r   o f   a r g u m e n t s   p a s s e d   t o   t h e   N P P _ E X E C   c o m m a n d 
 
 $ ( A R G V )     :     a l l   a r g u m e n t s   p a s s e d   t o   t h e   N P P _ E X E C   c o m m a n d   a f t e r   t h e   s c r i p t   n a m e 
 
 $ ( A R G V [ 0 ] )     :     s c r i p t   n a m e   -   f i r s t   p a r a m e t e r   o f   t h e   N P P _ E X E C   c o m m a n d 
 
 $ ( A R G V [ N ] )     :     N t h   a r g u m e n t   ( N = 1 , 2 , 3 . . . ) 
 
 $ ( R A R G V )     :     a l l   a r g u m e n t s   i n   r e v e r s e   o r d e r   ( e x c e p t   t h e   s c r i p t   n a m e ) 
 
 $ ( R A R G V [ N ] )     :     N t h   a r g u m e n t   i n   r e v e r s e   o r d e r   ( N = 1 , 2 , 3 . . . ) 
 
 $ ( I N P U T )     :     t h i s   v a l u e   i s   s e t   b y   t h e   ' i n p u t b o x '   c o m m a n d 
 
 $ ( I N P U T [ N ] )     :     N t h   f i e l d   o f   t h e   $ ( I N P U T )   v a l u e   ( N = 1 , 2 , 3 . . . ) 
 
 $ ( O U T P U T )     :     t h i s   v a l u e   c a n   b e   s e t   b y   t h e   c h i l d   p r o c e s s ,   s e e   n p e _ c o n s o l e   v + 
 
 $ ( O U T P U T 1 )     :     f i r s t   l i n e   i n   $ ( O U T P U T ) 
 
 $ ( O U T P U T L )     :     l a s t   l i n e   i n   $ ( O U T P U T ) 
 
 $ ( E X I T C O D E )     :     e x i t   c o d e   o f   t h e   l a s t   e x e c u t e d   c h i l d   p r o c e s s 
 
 $ ( P I D )     :     p r o c e s s   i d   o f   t h e   c u r r e n t   ( o r   t h e   l a s t )   c h i l d   p r o c e s s 
 
 $ ( I S _ P R O C E S S )     :     i s   c h i l d   p r o c e s s   r u n n i n g   ( 1   -   y e s ,   0   -   n o ) 
 
 $ ( L A S T _ C M D _ R E S U L T )     :     r e s u l t   o f   t h e   l a s t   N p p E x e c ' s   c o m m a n d 
 
                                                   ( 1   -   s u c c e e d e d ,   0   -   f a i l e d ,   - 1   -   i n v a l i d   a r g ) 
 
 $ ( M S G _ R E S U L T )     :     r e s u l t   o f   ' n p p _ s e n d m s g [ e x ] '   o r   ' s c i _ s e n d m s g ' 
 
 $ ( M S G _ W P A R A M )     :     w P a r a m   ( o u t p u t )   o f   ' n p p _ s e n d m s g [ e x ] '   o r   ' s c i _ s e n d m s g ' 
 
 $ ( M S G _ L P A R A M )     :     l P a r a m   ( o u t p u t )   o f   ' n p p _ s e n d m s g [ e x ] '   o r   ' s c i _ s e n d m s g ' 
 
 $ ( N P P _ H W N D )     :     N o t e p a d + + ' s   m a i n   w i n d o w   h a n d l e 
 
 $ ( S C I _ H W N D )     :     c u r r e n t   S c i n t i l l a ' s   w i n d o w   h a n d l e 
 
 $ ( S C I _ H W N D 1 )     :     p r i m a r y   S c i n t i l l a ' s   w i n d o w   h a n d l e   ( m a i n   v i e w ) 
 
 $ ( S C I _ H W N D 2 )     :     s e c o n d a r y   S c i n t i l l a ' s   w i n d o w   h a n d l e   ( s e c o n d   v i e w ) 
 
 $ ( C O N _ H W N D )     :     N p p E x e c ' s   C o n s o l e   w i n d o w   h a n d l e   ( R i c h E d i t   c o n t r o l ) 
 
 $ ( F O C U S E D _ H W N D )     :     f o c u s e d   w i n d o w   h a n d l e 
 
 $ ( S Y S . < v a r > )     :     s y s t e m ' s   e n v i r o n m e n t   v a r i a b l e ,   e . g .   $ ( S Y S . P A T H ) 
 
 $ ( @ E X I T _ C M D )     :     a   c a l l b a c k   e x i t   c o m m a n d   f o r   a   c h i l d   p r o c e s s 
 
 $ ( @ E X I T _ C M D _ S I L E N T )     :     a   s i l e n t   ( n o n - p r i n t e d )   c a l l b a c k   e x i t   c o m m a n d 
 
 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     h e l p 
 
 U S A G E : 
 
     h e l p 
 
     h e l p   < c o m m a n d > 
 
     h e l p   a l l 
 
 D E S C R I P T I O N : 
 
     P r i n t s   h e l p   ; - ) 
 
 E X A M P L E S : 
 
     h e l p                       / /   p r i n t s   g e n e r a l   h e l p   i n f o r m a t i o n 
 
     h e l p   n p p _ o p e n     / /   p r i n t s   d e t a i l e d   i n f o r m a t i o n   a b o u t   t h e   N P P _ O P E N   c o m m a n d 
 
     h e l p   a l l               / /   p r i n t s   d e t a i l e d   i n f o r m a t i o n   a b o u t   a l l   a v a i l a b l e   c o m m a n d s 
 
 S E E   A L S O : 
 
     m a n u a l ,   a b o u t ,   v e r 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     v e r 
 
 U S A G E : 
 
     v e r                           ( * ) 
 
     *   a v a i l a b l e   i n   t h e   C o n s o l e   d i a l o g   o n l y 
 
 D E S C R I P T I O N : 
 
     P r i n t s   p l u g i n ' s   v e r s i o n 
 
 S E E   A L S O : 
 
     a b o u t ,   h e l p ,   m a n u a l 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     m a n u a l 
 
 U S A G E : 
 
     m a n u a l                     ( * ) 
 
     *   a v a i l a b l e   i n   t h e   C o n s o l e   d i a l o g   o n l y 
 
 D E S C R I P T I O N : 
 
     S h o w s   N p p E x e c   U s e r   G u i d e 
 
 E X A M P L E S : 
 
     m a n u a l     / /   s h o w s   N p p E x e c   U s e r   G u i d e 
 
 S E E   A L S O : 
 
     h e l p ,   a b o u t ,   v e r 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     a b o u t 
 
 U S A G E : 
 
     a b o u t                       ( * ) 
 
     *   a v a i l a b l e   i n   t h e   C o n s o l e   d i a l o g   o n l y 
 
 D E S C R I P T I O N : 
 
     S h o w s   N p p E x e c   H e l p / A b o u t 
 
 E X A M P L E S : 
 
     a b o u t     / /   s h o w s   N p p E x e c   H e l p / A b o u t 
 
 S E E   A L S O : 
 
     v e r ,   h e l p ,   m a n u a l 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     c l s 
 
 U S A G E : 
 
     c l s 
 
 D E S C R I P T I O N : 
 
     C l e a r s   t h e   C o n s o l e   s c r e e n 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     c d 
 
 U S A G E : 
 
     c d 
 
     c d   < r e l a t i v e _ p a t h > 
 
     c d   < a b s o l u t e _ p a t h > 
 
 D E S C R I P T I O N : 
 
     1 .   C h a n g e s   c u r r e n t   d i r e c t o r y   ( " c d "   w i t h   p a r a m e t e r s ) 
 
     2 .   S h o w s   c u r r e n t   d i r e c t o r y   p a t h   ( " c d "   w i t h o u t   p a r a m e t e r s ) 
 
 E X A M P L E S : 
 
     c d               / /   s h o w s   c u r r e n t   d i r e c t o r y   p a t h 
 
     c d   . .         / /   g o   t o   u p - d i r e c t o r y 
 
     c d   \           / /   g o   t o   r o o t - d i r e c t o r y 
 
     c d   $ ( N P P _ D I R E C T O R Y )         / /   g o   t o   n o t e p a d + + ' s   d i r e c t o r y 
 
     c d   e : \ t e m p                         / /   c h a n g e   d r i v e   a n d   d i r e c t o r y 
 
 S E E   A L S O : 
 
     d i r 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     d i r 
 
 U S A G E : 
 
     d i r 
 
     d i r   < p a t h > 
 
     d i r   < m a s k > 
 
     d i r   < p a t h \ m a s k > 
 
 D E S C R I P T I O N : 
 
     1 .   L i s t s   a l l   s u b d i r s   a n d   f i l e s   i n   c u r r e n t / s p e c i f i e d   d i r e c t o r y     ( * ) 
 
     2 .   L i s t s   s u b d i r s   a n d   f i l e s   m a t c h e d   t h e   m a s k                                       ( * * ) 
 
       *   c u r r e n t   d i r e c t o r y   c a n   b e   s e t   b y   t h e   " c d "   c o m m a n d 
 
     * *   t y p e   " h e l p   m a s k "   f o r   m o r e   i n f o r m a t i o n   a b o u t   f i l e   m a s k s 
 
 E X A M P L E S : 
 
     d i r                                   / /   l i s t   a l l   s u b d i r s   a n d   f i l e s   i n   c u r r e n t   d i r e c t o r y 
 
     d i r   *                               / /   t h e   s a m e 
 
     d i r   d : \ d o c s \ * . t x t       / /   l i s t   a l l   * . t x t   f i l e s   i n   t h e   f o l d e r   d : \ d o c s 
 
 S E E   A L S O : 
 
     c d ,   m a s k ,   n p p _ o p e n 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     e c h o 
 
 U S A G E : 
 
     e c h o   < t e x t > 
 
 D E S C R I P T I O N : 
 
     P r i n t s   a   t e x t   i n   t h e   C o n s o l e   ( t h e   e n v i r o n m e n t   v a r i a b l e s   a r e   s u p p o r t e d ) 
 
 E X A M P L E S : 
 
     e c h o   N o t e p a d + + ' s   d i r e c t o r y   i s :   $ ( N P P _ D I R E C T O R Y ) 
 
 S E E   A L S O : 
 
     s l e e p ,   s e t 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     c o n _ c o l o u r 
 
 U S A G E : 
 
     c o n _ c o l o u r 
 
     c o n _ c o l o u r   f g   =   < R R   G G   B B > 
 
     c o n _ c o l o u r   b g   =   < R R   G G   B B > 
 
     c o n _ c o l o u r   f g   =   < R R   G G   B B >   b g   =   < R R   G G   B B > 
 
     c o n _ c o l o u r   f g   =   0 
 
     c o n _ c o l o u r   b g   =   0 
 
     c o n _ c o l o u r   f g   =   0   b g   =   0 
 
     c o n _ c o l o u r   l o c a l   f g   =   < R R   G G   B B >   b g   =   < R R   G G   B B > 
 
 D E S C R I P T I O N : 
 
     f g   -   s e t s   f o r e g r o u n d   ( t e x t )   c o l o u r   o f   t h e   C o n s o l e ; 
 
     b g   -   s e t s   b a c k g r o u n d   c o l o u r   o f   t h e   C o n s o l e ; 
 
     w i t h o u t   p a r a m e t e r s   -   s h o w s   c u r r e n t   v a l u e s   o f   t h e   c o l o u r s ; 
 
     t h e   v a l u e   o f   0   r e s t o r e s   t h e   o r i g i n a l   c o l o u r ( s ) . 
 
     W h e n   " l o c a l "   i s   s p e c i f i e d ,   t h e   c h a n g e s   a r e   a p p l i e d   l o c a l l y   t o   t h e   c u r r e n t 
 
     N p p E x e c ' s   s c r i p t   a n d   a r e   r e v e r t e d   b a c k   w h e n   t h e   c u r r e n t   s c r i p t   e n d s . 
 
 E X A M P L E S : 
 
     c o n _ c o l o u r   b g = 3 0 3 0 3 0   f g = d 0 d 0 d 0           / /   w h i t e   t e x t   o n   d a r k - g r e y 
 
     c o n _ c o l o u r   f g   =   3 0 3 0 3 0   b g   =   D 0 D 0 D 0   / /   d a r k   t e x t   o n   l i g h t - g r e y 
 
     c o n _ c o l o u r   F G   =   2 0   2 0   9 0                       / /   d a r k - b l u e   t e x t 
 
     c o n _ c o l o u r   f g   =   0                                     / /   r e s t o r e   o r i g i n a l   t e x t   c o l o u r 
 
     c o n _ c o l o u r   l o c a l   f g   =   3 0 3 0 3 0               / /   d a r k - g r e y   t e x t   l o c a l l y 
 
 R E M A R K S : 
 
     T h e   f o r e g r o u n d   ( t e x t )   c o l o u r   i s   a p p l i e d   t o   n e w   t e x t   o n l y . 
 
     T h e   b a c k g r o u n d   c o l o u r   i s   a p p l i e d   t o   t h e   w h o l e   C o n s o l e ' s   b a c k g r o u n d .   A n d 
 
     w h e n   i t   i s   b e i n g   a p p l i e d ,   a l l   t h e   t e x t   i s   b e i n g   r e - c o l o u r e d   t o   t h e   c u r r e n t 
 
     f o r e g r o u n d   c o l o u r . 
 
     < R R   G G   B B >   a r e   h e x   v a l u e s   o f   R i g h t ,   G r e e n   a n d   B l u e   c o m p o n e n t s   o f   a   c o l o u r 
 
     t o   b e   u s e d .   E a c h   c o l o u r   c o m p o n e n t   c a n   h a v e   a   v a l u e   f r o m   0 0   t o   F F .   T h e   v a l u e 
 
     o f   0 0   m e a n s   a b s e n c e   o f   t h e   c o l o u r   c o m p o n e n t ,   F F   m e a n s   m a x i m u m .   T h u s , 
 
     0 0   0 0   0 0   m e a n s   " d a r k "   ( a b s e n c e   o f   a l l   c o l o u r s ) ,   0 0   F F   0 0   m e a n s   " m a x i m u m   o f 
 
     g r e e n " ,   F F   F F   F F   m e a n s   " m a x i m u m   w h i t e " . 
 
     T h e s e   c o l o u r s   a r e   r u n - t i m e   o n l y ,   t h e y   a r e   n o t   s a v e d   w h e n   N o t e p a d + +   e x i t s . 
 
     ( U s e   t h e   A d v a n c e d   O p t i o n s   t o   s e t   a n d   s a v e   t h e   c o l o u r s . ) 
 
 S E E   A L S O : 
 
     c o n _ f i l t e r ,   n p e _ c o n s o l e 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     c o n _ f i l t e r 
 
 U S A G E : 
 
     c o n _ f i l t e r   + x 5 / - x 5   + i 1 / - i 1   + f r 4 / - f r 4   + f r c 1 / - f r c 1   + h 1 0 / - h 1 0 
 
     c o n _ f i l t e r   l o c a l   . . . 
 
 D E S C R I P T I O N : 
 
     E n a b l e s   o r   d i s a b l e s   t h e   e X c l u d e / I n c l u d e / R e p l a c e / H i g h l i g h t   F i l t e r s 
 
     + x < N > / - x < N >           -   e n a b l e s / d i s a b l e s   t h e   N t h   e X c l u d e   M a s k   ( N   =   1 . . 5 ) 
 
     + i < N > / - i < N >           -   e n a b l e s / d i s a b l e s   t h e   N t h   I n c l u d e   M a s k   ( N   =   1 . . 5 ) 
 
     + f r < N > / - f r < N >       -   e n a b l e s / d i s a b l e s   t h e   N t h   R e p l a c i n g   F i l t e r   a n d 
 
                                         d e a c t i v a t e s   " M a t c h   c a s e "   ( N   =   1 . . 4 ) 
 
     + f r c < N > / - f r c < N >   -   e n a b l e s / d i s a b l e s   t h e   N t h   R e p l a c i n g   F i l t e r   a n d 
 
                                         a c t i v a t e s   " M a t c h   c a s e "   ( N   =   1 . . 4 ) 
 
     + h < N > / - h < N >           -   e n a b l e s / d i s a b l e s   t h e   N t h   H i g h l i g h t   M a s k   ( N   =   1 . . 1 0 ) 
 
     W h e n   " l o c a l "   i s   s p e c i f i e d ,   t h e   c h a n g e s   a r e   a p p l i e d   l o c a l l y   t o   t h e   c u r r e n t 
 
     N p p E x e c ' s   s c r i p t   a n d   a r e   r e v e r t e d   b a c k   w h e n   t h e   c u r r e n t   s c r i p t   e n d s . 
 
 E X A M P L E S : 
 
     c o n _ f i l t e r   + f r c 3   + f r 2   - i 5   + x 2   + h 1 
 
     c o n _ f i l t e r   - x 4   + h 2   + i 1   - f r 3   + i 2   - h 7   + x 1   + f r 1   + f r c 2 
 
     c o n _ f i l t e r   l o c a l   - x 4   + h 2   + i 1   - f r 3     / /   h a s   l o c a l   e f f e c t 
 
 R E M A R K S : 
 
     T h i s   c o m m a n d   a l l o w s   t o   e n a b l e   a n d   d i s a b l e   t h e   C o n s o l e   O u t p u t   F i l t e r s   f r o m 
 
     y o u r   s c r i p t . 
 
     W h e n   a n y   e X c l u d e   o r   I n c l u d e   m a s k   i s   e n a b l e d ,   t h e   " E n a b l e   C o n s o l e   O u t p u t   F i l t e r " 
 
     c h e c k - b o x   b e c o m e s   c h e c k e d . 
 
     W h e n   a n y   R e p l a c i n g   F i l t e r   i s   e n a b l e d ,   t h e   " E n a b l e   R e p l a c i n g   F i l t e r s "   c h e c k - b o x 
 
     b e c o m e s   c h e c k e d . 
 
     W h i l e   u s i n g   C O N _ F I L T E R   t o   e n a b l e   o r   d i s a b l e   t h e   C o n s o l e   O u t p u t   F i l t e r s   a n d   h a v i n g 
 
     m a c r o - v a r i a b l e s   a s   t h e   v a l u e s   o f   t h e s e   F i l t e r s ,   y o u   a r e   a b l e   t o   a p p l y   d i f f e r e n t 
 
     f i l t e r s   d u r i n g   e x e c u t i o n   o f   y o u r   s c r i p t   -   t h u s   h a v i n g   t h e   f u l l   c o n t r o l   o v e r   t h e 
 
     f i l t e r s   a t   r u n t i m e . 
 
     T o   i l l u s t r a t e   t h e   l a s t   s e n t e n c e ,   l e t ' s   a s s u m e   y o u   h a v e   s p e c i f i e d   t h e   f o l l o w i n g 
 
     v a r i a b l e s   a s   f i l t e r s   i n   t h e   C o n s o l e   O u t p u t   F i l t e r s : 
 
         $ ( E x c l u d e 5 )   a s   t h e   5 t h   E x c l u d e   m a s k ; 
 
         $ ( I n c l u d e 5 )   a s   t h e   5 t h   I n c l u d e   m a s k ; 
 
         $ ( F i n d 4 )   a n d   $ ( R e p l a c e 4 )   a s   t h e   4 t h   R e p l a c i n g   F i l t e r ; 
 
         $ ( H i g h l i g h t 1 0 )   a s   t h e   1 0 t h   H i g h l i g h t   m a s k . 
 
     N o w   y o u   c a n   w r i t e   t h e   f o l l o w i n g   s c r i p t : 
 
         / /   s e t   t h e   f i l t e r s   d y n a m i c a l l y 
 
         s e t   E x c l u d e 5   =   * ( C ) *           / /   e x c l u d e   a n y   l i n e   t h a t   c o n t a i n s   " ( C ) " 
 
         s e t   I n c l u d e 5   =   *                   / /   i n c l u d e   a n y   l i n e 
 
         s e t   F i n d 4   =   /                         / /   f i n d   a l l   ' / ' . . . 
 
         s e t   R e p l a c e 4   =   \                   / /   . . . a n d   r e p l a c e   w i t h   ' \ ' 
 
         s e t   H i g h l i g h t 1 0   =   e r r o r *   / /   h i g h l i g h t   a n y   l i n e   t h a t   s t a r t s   w i t h   " e r r o r " 
 
         c o n _ f i l t e r   + x 5   + i 5   + f r 4   + h 1 0     / /   e n a b l e   t h e   a b o v e   f i l t e r s 
 
 S E E   A L S O : 
 
     c o n _ c o l o u r ,   n p e _ c o n s o l e ,   n p p _ c o n s o l e 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     c o n _ l o a d f r o m 
 
 U S A G E : 
 
     c o n _ l o a d f r o m   < f i l e > 
 
 D E S C R I P T I O N : 
 
     L o a d s   a   f i l e ' s   c o n t e n t   t o   t h e   C o n s o l e 
 
 E X A M P L E S : 
 
     c o n _ l o a d f r o m   c : \ t e m p \ o u t p u t . t x t 
 
 R E M A R K S : 
 
     U n i c o d e   v e r s i o n   o f   N p p E x e c   c a n   r e a d   A N S I ,   U T F - 8 ,   U C S - 2   L E   a n d 
 
     U C S - 2   B E   t e x t   f i l e s 
 
 S E E   A L S O : 
 
     c o n _ s a v e t o 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     c o n _ s a v e t o 
 
 U S A G E : 
 
     c o n _ s a v e t o   < f i l e > 
 
 D E S C R I P T I O N : 
 
     S a v e s   t h e   C o n s o l e ' s   c o n t e n t   t o   a   f i l e 
 
 E X A M P L E S : 
 
     c o n _ s a v e t o   c : \ t e m p \ o u t p u t . t x t 
 
 R E M A R K S : 
 
     U n i c o d e   v e r s i o n   o f   N p p E x e c   s a v e s   t h e   C o n s o l e ' s   c o n t e n t   a s 
 
     a n   U n i c o d e   t e x t   f i l e   ( U C S - 2   L E ) 
 
 S E E   A L S O : 
 
     c o n _ l o a d f r o m 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     n p p _ c l o s e 
 
 U S A G E : 
 
     n p p _ c l o s e 
 
     n p p _ c l o s e   < f i l e > 
 
 D E S C R I P T I O N : 
 
     1 .   C l o s e s   c u r r e n t   f i l e   ( " n p p _ c l o s e "   w i t h o u t   p a r a m e t e r s ) 
 
     2 .   C l o s e s   s p e c i f i e d   o p e n e d   f i l e 
 
           ( s u p p o r t s   a   p a r t i a l   f i l e   p a t h / n a m e ) 
 
 E X A M P L E S : 
 
     n p p _ c l o s e   $ ( # 3 )     / /   c l o s e s   3 r d   f i l e   o p e n e d   i n   N o t e p a d + + 
 
     n p p _ c l o s e   a w k         / /   c l o s e s   a   f i r s t   f i l e   w h i c h   c o n t a i n s   " a w k "   i n   i t s   n a m e 
 
 S E E   A L S O : 
 
     n p p _ o p e n ,   n p p _ s w i t c h ,   n p p _ s a v e 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     n p p _ c o n s o l e 
 
 U S A G E : 
 
     n p p _ c o n s o l e   < o n / o f f / k e e p > 
 
     n p p _ c o n s o l e   < e n a b l e / d i s a b l e > 
 
     n p p _ c o n s o l e   < 1 / 0 / ? > 
 
     n p p _ c o n s o l e   < + / - > 
 
     n p p _ c o n s o l e   l o c a l   . . . 
 
 D E S C R I P T I O N : 
 
     S h o w s / h i d e s   t h e   C o n s o l e   w i n d o w . 
 
     E n a b l e s / d i s a b l e s   o u t p u t   t o   t h e   C o n s o l e . 
 
     U s u a l l y   t h e   C o n s o l e   w i n d o w   i s   a u t o m a t i c a l l y   o p e n e d   e a c h   t i m e   y o u   e x e c u t e 
 
     s o m e   c o m m a n d   o r   s c r i p t ,   s o   t h e   p u r p o s e   o f   t h i s   c o m m a n d   i s   t o   c h a n g e   t h e 
 
     d e f a u l t   b e h a v i o u r . 
 
     W h e n   " l o c a l "   i s   s p e c i f i e d ,   t h e   c h a n g e s   a r e   a p p l i e d   l o c a l l y   t o   t h e   c u r r e n t 
 
     N p p E x e c ' s   s c r i p t   a n d   a r e   r e v e r t e d   b a c k   w h e n   t h e   c u r r e n t   s c r i p t   e n d s . 
 
 E X A M P L E S : 
 
     n p p _ c o n s o l e   ?     / /   k e e p   t h e   C o n s o l e ' s   s t a t e :   h i d d e n   C o n s o l e   i s   n o t   s h o w n 
 
     n p p _ c o n s o l e   1     / /   o p e n   ( s h o w )   t h e   C o n s o l e 
 
     n p p _ c o n s o l e   0     / /   c l o s e   ( h i d e )   t h e   C o n s o l e 
 
     n p p _ c o n s o l e   -     / /   d i s a b l e   o u t p u t   t o   t h e   C o n s o l e 
 
     n p p _ c o n s o l e   +     / /   e n a b l e   o u t p u t   t o   t h e   C o n s o l e 
 
     n p p _ c o n s o l e   l o c a l   0     / /   c l o s e   t h e   C o n s o l e   l o c a l l y 
 
 R E M A R K S : 
 
     Y o u   c a n   u s e   ' N P P _ C O N S O L E   ? '   a s   a   f i r s t   c o m m a n d   o f   y o u r   s c r i p t   i n   o r d e r   t o 
 
     k e e p   t h e   C o n s o l e ' s   s t a t e :   d o n ' t   o p e n   h i d d e n   C o n s o l e   o r   d o n ' t   h i d e   o p e n e d   o n e . 
 
     I f   y o u   w a n t   t o   a p p l y   ' N P P _ C O N S O L E   ? '   t o   e v e r y   s c r i p t ,   y o u   d o n ' t   h a v e   t o   a d d 
 
     t h i s   c o m m a n d   t o   t h e   b e g i n n i n g   o f   e a c h   s c r i p t .   A n   a u x i l i a r y   s c r i p t   c a n   b e   c r e a t e d 
 
     i n   o r d e r   t o   s t a r t   e v e r y   s c r i p t   u s i n g   t h i s   a u x i l i a r y   s c r i p t : 
 
     
 
         / /   a u x i l i a r y   s c r i p t 
 
         N P P _ C O N S O L E   ?     / /   k e e p   t h e   C o n s o l e ' s   s t a t e 
 
         N P P _ E X E C   $ ( A R G V )     / /   e x e c u t e   N p p E x e c ' s   s c r i p t   p a s s e d   a s   t h e   a r g u m e n t 
 
     
 
     N o w   y o u   c a n   s t a r t   a n y   s c r i p t   u s i n g 
 
         N P P _ E X E C   " a u x i l i a r y   s c r i p t "   " s c r i p t   t o   b e   e x e c u t e d " 
 
     
 
     I f   y o u   d i s a b l e   o u t p u t   t o   t h e   C o n s o l e   v i a   ' N P P _ C O N S O L E   - ' ,   y o u   w i l l   n o t   s e e   a n y 
 
     o u t p u t   n e i t h e r   f r o m   i n t e r n a l   n o r   f r o m   e x t e r n a l   c o m m a n d s   u n t i l   y o u   e n a b l e   i t 
 
     v i a   ' N P P _ C O N S O L E   + ' . 
 
     I f   y o u   c a l l   ' N P P _ C O N S O L E   - '   b e f o r e   r u n n i n g   a   c h i l d   p r o c e s s ,   y o u   w i l l   n o t   s e e 
 
     a n y   p r o m p t   e v e n   i f   t h e   p r o c c e s s   w a i t s   f o r   u s e r   i n p u t .   A n d   ' N P P _ C O N S O L E   + ' 
 
     w i l l   n o t   w o r k   u n t i l   t h e   c h i l d   p r o c e s s   f i n i s h e s . 
 
     S t a r t i n g   f r o m   N p p E x e c   v 0 . 6 ,   t h e   c o m m a n d   ' N P P _ C O N S O L E   - '   h a s   a   " l o c a l "   e f f e c t : 
 
     w h e n   t h i s   c o m m a n d   i s   e x e c u t e d   w i t h i n   a   s c r i p t ,   t h e   C o n s o l e   o u t p u t   i s   e n a b l e d 
 
     a u t o m a t i c a l l y   w h e n   t h e   s c r i p t   e n d s .   I f ,   h o w e v e r ,   t h i s   s c r i p t   i s   e x e c u t e d   v i a 
 
     N P P _ E X E C ,   t h e   C o n s o l e   r e m a i n s   d i s a b l e d . 
 
 S E E   A L S O : 
 
     n p e _ c o n s o l e ,   p r o c _ s i g n a l ,   @ e x i t _ c m d   ( " h e l p   @ e x i t _ c m d " ) 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     n p p _ e x e c 
 
 U S A G E : 
 
     n p p _ e x e c   < s c r i p t > 
 
     n p p _ e x e c   < f i l e > 
 
     n p p _ e x e c   < s c r i p t / f i l e >   < a r g s > 
 
 D E S C R I P T I O N : 
 
     1 .   E x e c u t e s   N p p E x e c ' s   c o m m a n d s   f r o m   a   s p e c i f i e d   s c r i p t 
 
     2 .   E x e c u t e s   N p p E x e c ' s   c o m m a n d s   f r o m   a   s p e c i f i e d   f i l e 
 
           ( s u p p o r t s   a   p a r t i a l   f i l e   p a t h / n a m e ) 
 
     3 .   E x e c u t e s   N p p E x e c ' s   c o m m a n d s   f r o m   a   s p e c i f i e d   s c r i p t / f i l e 
 
           a n d   p a s s e s   a d d i t i o n a l   a r g u m e n t s   t o   t h i s   s c r i p t . 
 
           T h e s e   a r g u m e n t s   c a n   b e   a c c e s s e d   i n   t h e   s c r i p t   t h r o u g h 
 
           t h e   f o l l o w i n g   m a c r o - v a r i a b l e s :   $ ( A R G C ) ,   $ ( A R G V ) , 
 
           $ ( A R G V [ n ] ) ,   $ ( R A R G V ) ,   $ ( R A R G V [ n ] ) 
 
 E X A M P L E S : 
 
     n p p _ e x e c   " a w k - r u n "                   / /   e x e c u t e s   N p p E x e c ' s   s c r i p t   n a m e d   " a w k - r u n " 
 
     n p p _ e x e c   " . . \ s c r i p t . t x t "       / /   e x e c u t e s   N p p E x e c ' s   f i l e   " . . \ s c r i p t . t x t " 
 
     n p p _ e x e c   " . . \ s c r i p t "               / /   t h e   s a m e   ( i f   t h e r e   i s   n o   o t h e r   f i l e s   w i t h   s i m i l a r   n a m e ) 
 
     n p p _ e x e c   " s c r i p t "   p 1   " p   2 "   / /   i n   t h e   s c r i p t :   $ ( A R G V [ 1 ] )   =   p 1 ,   $ ( A R G V [ 2 ] )   =   p   2 
 
     / /   A n   e x a m p l e   w i t h   n p p _ e x e c   < f i l e > : 
 
     / /   1 .   C r e a t e   a   n e w   f i l e   a n d   s a v e   i t   a s   e . g .   " t e s t . n p p e x e c " ; 
 
     / /   2 .   T y p e   t h e   f o l l o w i n g   l i n e   i n   t h i s   f i l e : 
 
     / /             e c h o   $ ( A R G V [ 1 ] ) 
 
     / /         a n d   s a v e   t h e   f i l e ; 
 
     / /   3 .   N o w   t y p e   t h e   f o l l o w i n g   i n   N p p E x e c ' s   C o n s o l e : 
 
     / /             n p p _ e x e c   " $ ( F U L L _ C U R R E N T _ P A T H ) "   " H e l l o ,   w o r l d ! " 
 
     / /   4 .   G o i n g   f u r t h e r ,   a   c o m m a n d   a l i a s   c a n   b e   a s s i g n e d : 
 
     / /             n p e _ c m d a l i a s   f   =   n p p _ e x e c   " $ ( F U L L _ C U R R E N T _ P A T H ) " 
 
     / /             f   " H e l l o ,   w o r l d ! " 
 
 R E M A R K S : 
 
     D o   _ n o t _   u s e   N P P _ E X E C   t o   s t a r t   a   b a t c h   f i l e   o r   a n   e x e c u t a b l e   f i l e   i n   N p p E x e c ! 
 
     T h e   p u r p o s e   o f   N P P _ E X E C   i s   t o   e x e c u t e   N p p E x e c ' s   o w n   s c r i p t . 
 
     T o   s t a r t   a   b a t c h   f i l e   o r   a n   e x e c u t a b l e   f i l e   i n   N p p E x e c ,   t y p e   j u s t : 
 
           a p p l i c a t i o n . e x e   / /   i n   c a s e   o f   a n   e x e c u t a b l e   f i l e   n a m e d   " a p p l i c a t i o n . e x e " 
 
           b a t c h f i l e . b a t       / /   i n   c a s e   o f   a   b a t c h   f i l e   n a m e d   " b a t c h f i l e . b a t " 
 
 S E E   A L S O : 
 
     n p p _ e x e c t e x t 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     n p p _ e x e c t e x t 
 
 U S A G E : 
 
     n p p _ e x e c t e x t   < m o d e >   < t e x t > 
 
 D E S C R I P T I O N : 
 
     E x e c u t e s   t h e   g i v e n   t e x t   a s   N p p E x e c ' s   s c r i p t   o r   s e n d s   t h i s   t e x t   t o 
 
     t h e   r u n n i n g   c h i l d   p r o c e s s   a s   a n   i n p u t . 
 
     T h e   v a l u e   o f   < m o d e >   c a n   b e   e i t h e r   0   o r   a   s u m   o f   t h e s e   f l a g s : 
 
     0 :     u s e   t h e   g i v e n   t e x t   a s   i s ; 
 
             i f   t h e r e   i s   a   r u n n i n g   c h i l d   p r o c e s s   t h e n   s e n d   t h e   t e x t   t o 
 
             t h a t   p r o c e s s   a s   a n   i n p u t ; 
 
     4 :     ( c s )   i f   t h e   f i r s t   l i n e   o f   t h e   t e x t   i s   " ! c o l l a t e r a l "   a n d   t h e r e   i s 
 
             n o   r u n n i n g   c h i l d   p r o c e s s   t h e n   s t a r t   a   c o l l a t e r a l   s c r i p t ; 
 
     8 :     ( c p )   i f   t h e   f i r s t   l i n e   o f   t h e   t e x t   i s   " ! c o l l a t e r a l "   a n d   t h e r e   i s 
 
             a   r u n n i n g   c h i l d   p r o c e s s   t h e n   s t a r t   a   c o l l a t e r a l   s c r i p t ; 
 
     1 6 :   ( n e )   l i n e s   t h a t   s t a r t   w i t h   t h e   " n p p e x e c : "   p r e f i x   w i l l   b e   e x e c u t e d   b y 
 
             N p p E x e c   ( a s   N p p E x e c ' s   s c r i p t   c o m m a n d s )   a n d   w i l l   n o t   b e   s e n t   t o   a 
 
             r u n n i n g   c h i l d   p r o c e s s ; 
 
     6 4 :   ( s v )   s h a r e   l o c a l   v a r i a b l e s :   n p p _ e x e c t e x t   u s e s   a n d   u p d a t e s   t h e   e x i s t i n g 
 
             l o c a l   v a r i a b l e s   i n s t e a d   o f   i t s   o w n   l o c a l   v a r i a b l e s . 
 
 E X A M P L E S : 
 
     n p p _ e x e c t e x t   0   $ ( C L I P B O A R D _ T E X T ) 
 
     n p p _ e x e c t e x t   2 8   $ ( S E L E C T E D _ T E X T )   / /   p r o c e s s   " ! c o l l a t e r a l "   a n d   " n p p e x e c : " 
 
     s e t   l o c a l   A   =   1 2 3 
 
     n p p _ e x e c t e x t   0   e c h o   A   i s   $ ( A ) 
 
     s e t   l o c a l   c m d s   ~   s t r u n e s c a p e   ! c o l l a t e r a l \ n m e s s a g e b o x   H e l l o ! ! ! 
 
     n p p _ e x e c t e x t   1 2   $ ( c m d s )   / /   p r o c e s s   " ! c o l l a t e r a l " 
 
 S E E   A L S O : 
 
     n p p _ e x e c 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     n p p _ m e n u c o m m a n d 
 
 U S A G E : 
 
     n p p _ m e n u c o m m a n d   < f u l l   n a m e   o f   m e n u   i t e m > 
 
 D E S C R I P T I O N : 
 
     E x e c u t e s   ( i n v o k e s )   a   m e n u   i t e m   b y   i t s   f u l l   n a m e . 
 
 E X A M P L E S : 
 
     n p p _ m e n u c o m m a n d   F i l e \ N e w 
 
     n p p _ m e n u c o m m a n d   E d i t | B l a n k   O p e r a t i o n s | T r i m   L e a d i n g   a n d   T r a i l i n g   S p a c e 
 
     n p p _ m e n u c o m m a n d   P l u g i n s / P l u g i n   M a n a g e r / S h o w   P l u g i n   M a n a g e r 
 
     n p p _ m e n u c o m m a n d   P l u g i n s \ \ N p p E x e c \ \ H e l p / M a n u a l 
 
 R E M A R K S : 
 
     I n   g e n e r a l   c a s e ,   n a m e s   o f   m e n u   i t e m s   a r e   l a n g u a g e - s p e c i f i c .   I f   y o u   h a v e   a 
 
     t r a n s l a t e d   m e n u   i n   N o t e p a d + + ,   y o u   s h o u l d   u s e   t h e   m e n u   i t e m   n a m e s   y o u   s e e . 
 
     ( F o r   e x a m p l e ,   " n p p _ m e n u c o m m a n d   $09;| >2K9" . ) 
 
     T h e   m e n u   i t e m   n a m e s   a r e   p r o c e s s e d   c a s e - s e n s i t i v e l y ,   s o   " f i l e / n e w "   o r 
 
     " F i l e | n e w "   d o e s   n o t   c o r r e s p o n d   t o   t h e   m e n u   i t e m   " F i l e / N e w " . 
 
     Y o u   c a n   u s e   ' \ ' ,   ' / '   a n d   ' | '   a s   a   s e p a r a t o r .   M o r e o v e r ,   y o u   c a n   d o u b l e   o r 
 
     e v e n   t r i p l e   t h e   s e p a r a t o r   i f   a   m e n u   i t e m   a l r e a d y   c o n t a i n s   ' \ ' ,   ' / '   o r   ' | ' . 
 
     H o w e v e r ,   b e   s u r e   t o   u s e   t h e   v e r y   s a m e   s e p a r a t o r   w i t h i n   a   f u l l   n a m e   o f   m e n u 
 
     i t e m .   F o r   e x a m p l e :   " P l u g i n s | | N p p E x e c | | H e l p / M a n u a l "   i s   c o r r e c t   s i n c e   i t   u s e s 
 
     t h e   s a m e   s e p a r a t o r   " | | " .   A n d   " P l u g i n s \ \ N p p E x e c | | H e l p / M a n u a l "   i s   i n c o r r e c t 
 
     b e c a u s e   t h e   f i r s t   " \ \ "   h a s   b e e n   d e t e c t e d   a s   a   s e p a r a t o r ,   a n d   t h e   r e m a i n i n g 
 
     p a r t   " N p p E x e c | | H e l p / M a n u a l "   w o u l d   b e   t r e a t e d   a s   a   n a m e   o f   o n e   s u b - i t e m 
 
     s i n c e   i t   d i d   n o t   c o n t a i n   t h e   s e p a r a t o r   " \ \ " . 
 
     N o t e :   d o   n o t   f o r g e t   t h a t   " / / "   b y   d e f a u l t   i s   a   s t a r t   o f   a   c o m m e n t   i n   N p p E x e c . 
 
     S o   d o   n o t   u s e   d o u b l e d   " / / "   o r   t r i p l e d   " / / / "   a s   a   s e p a r a t o r   o f   m e n u   i t e m   n a m e 
 
     b e c a u s e   t h e   r e m a i n i n g   p a r t   o f   t h e   i t e m   n a m e   ( a f t e r   " / / "   o r   " / / / " )   w i l l   b e 
 
     t r e a t e d   a s   a   c o m m e n t   a n d   i g n o r e d . 
 
 S E E   A L S O : 
 
     n p p _ s e n d m s g 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     n p p _ o p e n 
 
 U S A G E : 
 
     n p p _ o p e n   < f i l e > 
 
     n p p _ o p e n   < m a s k > 
 
     n p p _ o p e n   < p a t h \ m a s k > 
 
 D E S C R I P T I O N : 
 
     1 .   O p e n s   o r   r e o p e n s   s p e c i f i e d   f i l e   i n   N o t e p a d + + 
 
     2 .   O p e n s   f i l e ( s )   m a t c h e d   t h e   m a s k                                 ( * ) 
 
     *   t y p e   " h e l p   m a s k "   f o r   m o r e   i n f o r m a t i o n   a b o u t   f i l e   m a s k s 
 
 E X A M P L E S : 
 
     n p p _ o p e n   * . t x t                           / /   o p e n s   a l l   * . t x t   f i l e s   i n   c u r r e n t   d i r e c t o r y 
 
     n p p _ o p e n   e : \ t e m p \ f i l e . t x t     / /   o p e n s   t h e   f i l e   " e : \ t e m p \ f i l e . t x t " 
 
     n p p _ o p e n   . \ t e x t \ * . *                 / /   o p e n s   a l l   f i l e s   i n   t h e   f o l d e r   " . \ t e x t " 
 
 R E M A R K S : 
 
     T o   r e o p e n   a   f i l e ,   s p e c i f y   t h e   f u l l   f i l e   p a t h . 
 
 S E E   A L S O : 
 
     n p p _ c l o s e ,   n p p _ s w i t c h ,   n p p _ s a v e ,   m a s k ,   d i r 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     n p p _ r u n 
 
 U S A G E : 
 
     n p p _ r u n   < c o m m a n d > 
 
     n p p _ r u n   < f i l e > 
 
 D E S C R I P T I O N : 
 
     1 .   T h e   s a m e   a s   N o t e p a d + + ' s   R u n   c o m m a n d   -   r u n s   a n   e x t e r n a l   p r o c e s s 
 
     2 .   O p e n s   s p e c i f i e d   f i l e   i n   i t s   a s s o c i a t e d   p r o g r a m   ( r e q u i r e s   N p p E x e c   v 0 . 2   R C 3 . 1   o r   h i g h e r ) 
 
 E X A M P L E S : 
 
     n p p _ r u n   c a l c . e x e         ( * ) 
 
     *   i f   y o u   t y p e   j u s t   " c a l c . e x e "   w i t h o u t   " n p p _ r u n " ,   t h e n   N p p E x e c   r u n s 
 
         " c a l c . e x e "   a s   a   c h i l d   p r o c e s s   a n d   w a i t s   u n t i l   i t   r e t u r n s   ( i . e .   u n t i l 
 
         y o u   c l o s e   t h e   c a l c ' s   w i n d o w ) 
 
     n p p _ r u n   " i n d e x . h t m l "   / /   o p e n s   " i n d e x . h t m l "   i n   y o u r   d e f a u l t   w e b - b r o w s e r 
 
     n p p _ r u n   " C : \ P r o g r a m   F i l e s \ M o z i l l a   F i r e f o x \ f i r e f o x . e x e "   " i n d e x . h t m l "   / /   i n   F i r e f o x 
 
     n p p _ r u n   " $ ( F U L L _ C U R R E N T _ P A T H ) "   / /   o p e n i n g   u s i n g   t h e   a s s o c i a t e d   p r o g r a m 
 
 R E M A R K S : 
 
     I n   t e r m s   o f   a n   a p p l i c a t i o n   ( a   p r o g r a m ) ,   N P P _ R U N   a l l o w s   t o   r u n   i t   i n   i t s   o w n 
 
     w i n d o w   w i t h o u t   w a i t i n g   f o r   i t s   e x e c u t i o n : 
 
         n p p _ r u n   a p p l i c a t i o n . e x e 
 
         n p p _ r u n   a p p l i c a t i o n . e x e   < a r g u m e n t s > 
 
     I f ,   h o w e v e r ,   t h e r e   i s   a   n e e d   t o   w a i t   u n t i l   t h e   a p p l i c a t i o n   h a s   b e e n   e x e c u t e d , 
 
     w h i l e   s t i l l   r u n n i n g   i t   i n   i t s   o w n   w i n d o w ,   i t   c a n   b e   a c h i e v e d   w i t h o u t   N P P _ R U N : 
 
         c m d   / c   s t a r t   / w a i t   a p p l i c a t i o n . e x e 
 
         c m d   / c   s t a r t   / w a i t   a p p l i c a t i o n . e x e   < a r g u m e n t s > 
 
     I n   t h i s   l a s t   c a s e ,   N p p E x e c   w a i t s   f o r   c m d   t o   b e   e x e c u t e d ,   w h i l e   c m d   i t s e l f 
 
     s t a r t s   t h e   a p p l i c a t i o n   i n   i t s   o w n   s e p a r a t e   w i n d o w   a n d   w a i t s   u n t i l   i t   h a s 
 
     b e e n   e x e c u t e d . 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     n p p _ s a v e 
 
 U S A G E : 
 
     n p p _ s a v e 
 
     n p p _ s a v e   < f i l e > 
 
 D E S C R I P T I O N : 
 
     1 .   S a v e s   c u r r e n t   f i l e   ( " n p p _ s a v e "   w i t h o u t   p a r a m e t e r s ) 
 
     2 .   S a v e s   s p e c i f i e d   f i l e   i f   i t ' s   o p e n e d   i n   N o t e p a d + + 
 
           ( s u p p o r t s   a   p a r t i a l   f i l e   p a t h / n a m e ) 
 
 E X A M P L E S : 
 
     n p p _ s a v e                   / /   s a v e s   c u r r e n t   f i l e 
 
     n p p _ s a v e   $ ( # 2 )       / /   s a v e s   2 n d   f i l e   o p e n e d   i n   N o t e p a d + + 
 
     n p p _ s a v e   t x t           / /   s a v e s   a   f i r s t   f i l e   w h i c h   c o n t a i n s   " t x t "   i n   i t s   n a m e 
 
 S E E   A L S O : 
 
     n p p _ s a v e a s ,   n p p _ s a v e a l l ,   n p p _ o p e n 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     n p p _ s a v e a l l 
 
 U S A G E : 
 
     n p p _ s a v e a l l 
 
 D E S C R I P T I O N : 
 
     S a v e s   a l l   m o d i f i e d   f i l e s 
 
 E X A M P L E S : 
 
     n p p _ s a v e a l l 
 
 S E E   A L S O : 
 
     n p p _ s a v e ,   n p p _ s a v e a s ,   n p p _ o p e n 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     n p p _ s a v e a s 
 
 U S A G E : 
 
     n p p _ s a v e a s   < f i l e > 
 
 D E S C R I P T I O N : 
 
     S a v e s   c u r r e n t   f i l e   w i t h   a   n e w   ( p a t h ) n a m e 
 
 E X A M P L E S : 
 
     n p p _ s a v e a s   $ ( S Y S . T E M P ) \ n e w n a m e . t x t 
 
     n p p _ s a v e a s   a n o t h e r n a m e . t x t 
 
 S E E   A L S O : 
 
     n p p _ s a v e ,   n p p _ s a v e a l l ,   n p p _ o p e n 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     n p p _ s w i t c h 
 
 U S A G E : 
 
     n p p _ s w i t c h   < f i l e > 
 
 D E S C R I P T I O N : 
 
     S w i t c h e s   t o   s p e c i f i e d   o p e n e d   f i l e 
 
     ( s u p p o r t s   a   p a r t i a l   f i l e   p a t h / n a m e ) 
 
 E X A M P L E S : 
 
     n p p _ s w i t c h   $ ( # 3 )     / /   a c t i v a t e s   3 r d   f i l e   o p e n e d   i n   N o t e p a d + + 
 
     n p p _ s w i t c h   a w k         / /   a c t i v a t e s   a   f i r s t   f i l e   w h i c h   c o n t a i n s   " a w k "   i n   i t s   n a m e 
 
 S E E   A L S O : 
 
     n p p _ o p e n ,   n p p _ c l o s e ,   n p p _ s a v e 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     n p p _ s e t f o c u s 
 
 U S A G E : 
 
     n p p _ s e t f o c u s   c o n 
 
     n p p _ s e t f o c u s   s c i 
 
 D E S C R I P T I O N : 
 
     S e t s   t h e   k e y b o a r d   f o c u s   ( t o   t h e   C o n s o l e   o r   t o   S c i n t i l l a ' s   e d i t i n g   w i n d o w ) 
 
 E X A M P L E S : 
 
     n p p _ s e t f o c u s   c o n     / /   s e t s   t h e   f o c u s   t o   N p p E x e c ' s   C o n s o l e 
 
     n p p _ s e t f o c u s   s c i     / /   s e t s   t h e   f o c u s   t o   t h e   c u r r e n t   S c i n t i l l a 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     n p p _ s e n d m s g 
 
 U S A G E : 
 
     n p p _ s e n d m s g   < m s g > 
 
     n p p _ s e n d m s g   < m s g >   < w p a r a m > 
 
     n p p _ s e n d m s g   < m s g >   < w p a r a m >   < l p a r a m > 
 
       *   W a r n i n g :   i n c o r r e c t   u s a g e   o f   t h i s   c o m m a n d   m a y   c r a s h   N o t e p a d + +   ! ! ! 
 
 D E S C R I P T I O N : 
 
     S e n d s   a   m e s s a g e   t o   N o t e p a d + +   ( t o   i t s   m a i n   w i n d o w ) . 
 
     T h i s   c o m m a n d   i n v o k e s   W i n   A P I   f u n c t i o n   S e n d M e s s a g e : 
 
         L R E S U L T   S e n d M e s s a g e ( h N p p W n d ,   M s g ,   w P a r a m ,   l P a r a m ) 
 
     w h e r e   l P a r a m   o r   b o t h   l P a r a m   a n d   w P a r a m   c a n   b e   o m i t t e d . 
 
     < w p a r a m >   a n d   < l p a r a m >   c a n   b e   t h e   f o l l o w i n g : 
 
         < i n t >         -   i n t e g e r   v a l u e   ( i n t   o r   D W O R D ) 
 
         @ < i n t >       -   p o i n t e r   t o   i n t e g e r   ( L P D W O R D   - >   s i g n e d   i n t ) 
 
         " < s t r > "     -   c o n s t   s t r i n g   ( L P C T S T R ) 
 
         @ " < s t r > "   -   p o i n t e r   t o   s t r i n g   ( L P T S T R ) 
 
     U s e   < i n t >   a n d   " < s t r > "   t o   p a s s   i n t e g e r   o r   s t r i n g   t o   N o t e p a d + + : 
 
     e . g .   1 0 ,   0 x 1 E ,   " s o m e   t e x t " . 
 
     U s e   @ < i n t >   a n d   @ " s t r "   t o   g e t   i n t e g e r   o r   s t r i n g   f r o m   N o t e p a d + + : 
 
     e . g .   @ 0 ,   @ 0 x 7 F F ,   @ " " ,   @ " i n i t i a l   s t r i n g " . 
 
     W h e n   u s i n g   @ < i n t >   a n d   @ " < s t r > " ,   t h e   v a l u e s   s p e c i f i e d   a r e 
 
     i n i t i a l   v a l u e s   o f   t h e   p a r a m e t e r s . 
 
     N p p E x e c   r e s e r v e s   a   b u f f e r   o f   ( 4   M B ) * s i z e o f ( T C H A R )   f o r   @ " < s t r > " . 
 
     W h e n   o m i t t i n g   < w p a r a m >   o r   < l p a r a m > ,   N p p E x e c   t r e a t s   t h e   o m i t t e d 
 
     p a r a m e t e r ( s )   a s   0   ( 0   a s   i n t ) . 
 
     T h i s   c o m m a n d   s e t s   t h e   f o l l o w i n g   l o c a l   v a r i a b l e s : 
 
         $ ( M S G _ R E S U L T )   -   L R E S U L T   a s   i n t 
 
         $ ( M S G _ W P A R A M )   -   i n t   o r   s t r i n g   f o r   @ < i n t >   o r   @ " < s t r > " ,   o t h e r w i s e   e m p t y 
 
         $ ( M S G _ L P A R A M )   -   i n t   o r   s t r i n g   f o r   @ < i n t >   o r   @ " < s t r > " ,   o t h e r w i s e   e m p t y 
 
     S e e   M S D N   f o r   m o r e   d e t a i l s   a b o u t   S e n d M e s s a g e . 
 
     S e e   N o t e p a d + + ' e s   s o u r c e s   a n d   d o c u m e n t a t i o n   f o r   m o r e   d e t a i l s 
 
     a b o u t   m e s s a g e s   s u p p o r t e d   b y   N o t e p a d + + . 
 
 E X A M P L E S : 
 
     / /   ! ! !   A l l   N P P M _ *   m e s s a g e s   m u s t   b e   s p e c i f i e d   i n   u p p e r   c a s e   ! ! ! 
 
     / /   ! ! !   ( T h e s e   m e s s a g e s   a r e   r e a d   f r o m   N p p E x e c \ N o t e p a d _ p l u s _ m s g s . h )   ! ! ! 
 
     / /   N P P M _ G E T N P P V E R S I O N   e x a m p l e : 
 
     n p p _ s e n d m s g   N P P M _ G E T N P P V E R S I O N     / /   r e t u r n s   v e r   a s   L R E S U L T 
 
     s e t   l o c a l   h v e r   ~   t r u n c ( $ ( M S G _ R E S U L T ) / 6 5 5 3 6 )     / /   H I W O R D ( v e r ) 
 
     s e t   l o c a l   l v e r   ~   $ ( M S G _ R E S U L T )   -   $ ( h v e r ) * 6 5 5 3 6     / /   L O W O R D ( v e r ) 
 
     e c h o   $ ( h v e r ) . $ ( l v e r )     / /   p r i n t s   v e r s i o n   a s   s t r i n g 
 
     / /   N P P M _ G E T P L U G I N S C O N F I G D I R   e x a m p l e : 
 
     n p p _ s e n d m s g   N P P M _ G E T P L U G I N S C O N F I G D I R   4 0 0 0 0 0 0   @ " "     / /   s e n d   a   m e s s a g e 
 
     e c h o   $ ( M S G _ L P A R A M )     / /   p r i n t s   t h e   s t r i n g   p o i n t e d   b y   l P a r a m 
 
     / /   N P P M _ G E T F U L L P A T H F R O M B U F F E R I D   _ a d v a n c e d _   e x a m p l e : 
 
     n p p _ s e n d m s g   N P P M _ G E T C U R R E N T B U F F E R I D     / /   r e t u r n s   b u f f e r   I d   a s   r e s u l t 
 
     s e t   l o c a l   b u f f e r I d   =   $ ( M S G _ R E S U L T ) 
 
     n p p _ s e n d m s g   N P P M _ G E T F U L L P A T H F R O M B U F F E R I D   $ ( b u f f e r I d )   @ " " 
 
     e c h o   $ ( M S G _ L P A R A M )     / /   f i l e   p a t h   a s   s t r i n g 
 
     n p p _ s e n d m s g   N P P M _ G E T F U L L P A T H F R O M B U F F E R I D   $ ( b u f f e r I d )   @ [ ] 
 
     e c h o   $ ( M S G _ L P A R A M )     / /   f i l e   p a t h   a s   h e x   s t r i n g 
 
     / /   ( t h i s   l a s t   e x a m p l e   u s e s   u n d o c u m e n t e d   a b i l i t y   o f 
 
     / /     h a n d l i n g   o f   h e x - s t r i n g   p a r a m e t e r s ,   e . g . : 
 
     / /     [ 0 0   7 F   E A   0 0 ]   -   c o n s t   b u f f e r   o f   4   b y t e s 
 
     / /     @ [ F F   0 2   0 C ]       -   p o i n t e r   t o   b u f f e r 
 
     / /     U s e   i t   w i t h   c a r e ! ) 
 
 S E E   A L S O : 
 
     s c i _ s e n d m s g ,   n p p _ s e n d m s g e x ,   n p e _ s e n d m s g b u f l e n ,   s e t 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     n p p _ s e n d m s g e x 
 
 U S A G E : 
 
     n p p _ s e n d m s g e x   < h w n d >   < m s g > 
 
     n p p _ s e n d m s g e x   < h w n d >   < m s g >   < w p a r a m > 
 
     n p p _ s e n d m s g e x   < h w n d >   < m s g >   < w p a r a m >   < l p a r a m > 
 
       *   W a r n i n g :   i n c o r r e c t   u s a g e   o f   t h i s   c o m m a n d   m a y   c r a s h   s o m e t h i n g   ! ! ! 
 
 D E S C R I P T I O N : 
 
     S e n d s   a   m e s s a g e   t o   h w n d . 
 
     T h i s   c o m m a n d   i n v o k e s   W i n   A P I   f u n c t i o n   S e n d M e s s a g e : 
 
         L R E S U L T   S e n d M e s s a g e ( h W n d ,   M s g ,   w P a r a m ,   l P a r a m ) 
 
     w h e r e   l P a r a m   o r   b o t h   l P a r a m   a n d   w P a r a m   c a n   b e   o m i t t e d . 
 
     S e e   N P P _ S E N D M S G   a n d   S C I _ S E N D M S G   f o r   m o r e   d e t a i l s . 
 
 E X A M P L E S : 
 
     n p p _ s e n d m s g   N P P M _ D M M G E T P L U G I N H W N D B Y N A M E   " N p p E x e c   C o n s o l e "   " N p p E x e c . d l l " 
 
     s e t   l o c a l   h w n d   =   $ ( M S G _ R E S U L T )     / /   h w n d   o f   N p p E x e c ' s   C o n s o l e 
 
     n p p _ s e n d m s g e x   $ ( h w n d )   W M _ C O M M A N D   1 1 5 4   0     / /   W o r d - W r a p   c h e c k b o x 
 
 S E E   A L S O : 
 
     n p p _ s e n d m s g ,   s c i _ s e n d m s g ,   n p e _ s e n d m s g b u f l e n ,   s e t 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     s c i _ s e n d m s g 
 
 U S A G E : 
 
     s c i _ s e n d m s g   < m s g > 
 
     s c i _ s e n d m s g   < m s g >   < w p a r a m > 
 
     s c i _ s e n d m s g   < m s g >   < w p a r a m >   < l p a r a m > 
 
       *   W a r n i n g :   i n c o r r e c t   u s a g e   o f   t h i s   c o m m a n d   m a y   c r a s h   N o t e p a d + +   ! ! ! 
 
 D E S C R I P T I O N : 
 
     S e n d s   a   m e s s a g e   t o   c u r r e n t   S c i n t i l l a   ( t o   i t s   w i n d o w ) . 
 
     T h i s   c o m m a n d   i n v o k e s   W i n   A P I   f u n c t i o n   S e n d M e s s a g e : 
 
         L R E S U L T   S e n d M e s s a g e ( h S c i W n d ,   M s g ,   w P a r a m ,   l P a r a m ) 
 
     w h e r e   l P a r a m   o r   b o t h   l P a r a m   a n d   w P a r a m   c a n   b e   o m i t t e d . 
 
     < w p a r a m >   a n d   < l p a r a m >   c a n   b e   t h e   f o l l o w i n g : 
 
         < i n t >         -   i n t e g e r   v a l u e   ( i n t   o r   D W O R D ) 
 
         @ < i n t >       -   p o i n t e r   t o   i n t e g e r   ( L P D W O R D   - >   s i g n e d   i n t ) 
 
         " < s t r > "     -   c o n s t   s t r i n g   ( L P C T S T R ) 
 
         @ " < s t r > "   -   p o i n t e r   t o   s t r i n g   ( L P T S T R ) 
 
     U s e   < i n t >   a n d   " < s t r > "   t o   p a s s   i n t e g e r   o r   s t r i n g   t o   S c i n t i l l a : 
 
     e . g .   1 0 ,   0 x 1 E ,   " s o m e   t e x t " . 
 
     U s e   @ < i n t >   a n d   @ " s t r "   t o   g e t   i n t e g e r   o r   s t r i n g   f r o m   S c i n t i l l a : 
 
     e . g .   @ 0 ,   @ 0 x 7 F F ,   @ " " ,   @ " i n i t i a l   s t r i n g " . 
 
     W h e n   u s i n g   @ < i n t >   a n d   @ " < s t r > " ,   t h e   v a l u e s   s p e c i f i e d   a r e 
 
     i n i t i a l   v a l u e s   o f   t h e   p a r a m e t e r s . 
 
     N p p E x e c   r e s e r v e s   a   b u f f e r   o f   ( 4   M B ) * s i z e o f ( c h a r )   f o r   @ " < s t r > " . 
 
     N p p E x e c   p e r f o r m s   c o n v e r s i o n   f r o m / t o   A N S I   o r   U T F - 8   a u t o m a t i c a l l y . 
 
     W h e n   o m i t t i n g   < w p a r a m >   o r   < l p a r a m > ,   N p p E x e c   t r e a t s   t h e   o m i t t e d 
 
     p a r a m e t e r ( s )   a s   0   ( 0   a s   i n t ) . 
 
     T h i s   c o m m a n d   s e t s   t h e   f o l l o w i n g   l o c a l   v a r i a b l e s : 
 
         $ ( M S G _ R E S U L T )   -   L R E S U L T   a s   i n t 
 
         $ ( M S G _ W P A R A M )   -   i n t   o r   s t r i n g   f o r   @ < i n t >   o r   @ " < s t r > " ,   o t h e r w i s e   e m p t y 
 
         $ ( M S G _ L P A R A M )   -   i n t   o r   s t r i n g   f o r   @ < i n t >   o r   @ " < s t r > " ,   o t h e r w i s e   e m p t y 
 
     S e e   M S D N   f o r   m o r e   d e t a i l s   a b o u t   S e n d M e s s a g e . 
 
     S e e   S c i n t i l l a ' s   d o c u m e n t a t i o n   f o r   m o r e   d e t a i l s   a b o u t   m e s s a g e s 
 
     s u p p o r t e d   b y   S c i n t i l l a . 
 
 E X A M P L E S : 
 
     / /   ! ! !   A l l   S C I _ *   m e s s a g e s   m u s t   b e   s p e c i f i e d   i n   u p p e r   c a s e   ! ! ! 
 
     / /   ! ! !   ( T h e s e   m e s s a g e s   a r e   r e a d   f r o m   N p p E x e c \ S c i n t i l l a . h )   ! ! ! 
 
     / /   g e t   t h e   t e x t   o f   t h e   f i r s t   v i s i b l e   l i n e : 
 
     s c i _ s e n d m s g   S C I _ G E T F I R S T V I S I B L E L I N E     / /   r e t u r n s   l i n e   n u m b e r   a s   L R E S U L T 
 
     s c i _ s e n d m s g   S C I _ G E T L I N E   $ ( M S G _ R E S U L T )   @ " " 
 
     e c h o   $ ( M S G _ L P A R A M )     / /   p r i n t s   t h e   s t r i n g   p o i n t e d   b y   l P a r a m 
 
 S E E   A L S O : 
 
     n p p _ s e n d m s g ,   n p p _ s e n d m s g e x ,   n p e _ s e n d m s g b u f l e n ,   s e t 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     s c i _ f i n d 
 
 U S A G E : 
 
     s c i _ f i n d   < f l a g s >   < f i n d _ w h a t > 
 
 D E S C R I P T I O N : 
 
     S e a r c h e s   f o r   t h e   g i v e n   s t r i n g   a c c o r d i n g   t o   t h e   s p e c i f i e d   f l a g s . 
 
     T h e   a c t u a l   b e h a v i o r   c o m p l e t e l y   d e p e n d s   o n   t h e   < f l a g s >   s p e c i f i e d . 
 
     I t   i s   r e c o m m e n d e d   t o   e n q u o t e   t h e   " f i n d _ w h a t "   s t r i n g . 
 
     U s e   t h e   " B i t w i s e   O R "   o p e r a t o r   ' | '   t o   c o m b i n e   t h e   f l a g s . 
 
     T h e   f l a g s   c a n   b e   a   c o m b i n a t i o n   o f   t h e   f o l l o w i n g : 
 
         N P E _ S F _ M A T C H C A S E       =   0 x 0 0 0 0 0 0 0 1 
 
             -   " t e x t "   f i n d s   o n l y   " t e x t " ,   n o t   " T e x t "   o r   " T E X T " 
 
         N P E _ S F _ W H O L E W O R D       =   0 x 0 0 0 0 0 0 1 0 
 
             -   " w o r d "   f i n d s   o n l y   " w o r d " ,   n o t   " s w o r d "   o r   " w o r d s " 
 
         N P E _ S F _ W O R D S T A R T       =   0 x 0 0 0 0 0 0 2 0 
 
             -   " w o r d "   f i n d s   " w o r d "   a n d   " w o r d s " ,   n o t   " s w o r d " 
 
         N P E _ S F _ R E G E X P             =   0 x 0 0 0 0 0 1 0 0 
 
             -   s e a r c h   u s i n g   a   r e g u l a r   e x p r e s s i o n 
 
         N P E _ S F _ P O S I X               =   0 x 0 0 0 0 0 2 0 0 
 
             -   s e a r c h   u s i n g   a   P O S I X - c o m p a t i b l e   r e g u l a r   e x p r e s s i o n 
 
         N P E _ S F _ C X X 1 1 R E G E X     =   0 x 0 0 0 0 0 4 0 0 
 
             -   s e a r c h   u s i n g   a   C + + 1 1   r e g u l a r   e x p r e s s i o n 
 
         N P E _ S F _ B A C K W A R D         =   0 x 0 0 0 1 0 0 0 0 
 
             -   s e a r c h   b a c k w a r d   ( f r o m   t h e   b o t t o m   t o   t h e   t o p ) 
 
         N P E _ S F _ N E X T                 =   0 x 0 0 0 2 0 0 0 0 
 
             -   s e a r c h   f r o m   c u r r e n t _ p o s i t i o n   +   1 
 
         N P E _ S F _ I N S E L E C T I O N   =   0 x 0 0 1 0 0 0 0 0 
 
             -   s e a r c h   o n l y   i n   t h e   s e l e c t e d   t e x t 
 
         N P E _ S F _ I N E N T I R E T E X T   =   0 x 0 0 2 0 0 0 0 0 
 
             -   s e a r c h   i n   t h e   e n t i r e   t e x t ,   n o t   o n l y   f r o m   t h e   c u r r e n t   p o s i t i o n 
 
         N P E _ S F _ S E T P O S             =   0 x 0 1 0 0 0 0 0 0 
 
             -   m o v e   t h e   c a r e t   t o   t h e   p o s i t i o n   o f   t h e   o c c u r r e n c e   f o u n d 
 
         N P E _ S F _ S E T S E L             =   0 x 0 2 0 0 0 0 0 0 
 
             -   m o v e   t h e   c a r e t   +   s e l e c t   t h e   o c c u r r e n c e   f o u n d 
 
         N P E _ S F _ R E P L A C E A L L     =   0 x 1 0 0 0 0 0 0 0     / /   o n l y   f o r   s c i _ r e p l a c e 
 
             -   r e p l a c e   a l l   t h e   o c c u r r e n c e s   f r o m   t h e   c u r r e n t   p o s   t o   t h e   e n d 
 
         N P E _ S F _ P R I N T A L L         =   0 x 2 0 0 0 0 0 0 0 
 
             -   p r i n t   a l l   t h e   o c c u r r e n c e s   f r o m   t h e   c u r r e n t   p o s   t o   t h e   e n d 
 
     T h i s   c o m m a n d   s e t s   t h e   f o l l o w i n g   l o c a l   v a r i a b l e s : 
 
         $ ( M S G _ R E S U L T )   -   t h e   p o s i t i o n   o f   t h e   o c c u r r e n c e   f o u n d ,   o r   - 1 
 
         $ ( M S G _ W P A R A M )   -   < f i n d _ w h a t > ' s   l e n g t h   i n   S c i n t i l l a ' s   c h a r s   ( * ) 
 
         *   i n   c a s e   o f   r e g u l a r   e x p r e s s i o n ,   i t   i s   t h e   l e n g t h   o f   t h e   m a t c h e d   s t r i n g 
 
 E X A M P L E S : 
 
     / /   s e a r c h   f o r   " s o m e   t e x t " ,   s t a r t i n g   f r o m   t h e   c a r e t   p o s i t i o n : 
 
     s c i _ f i n d   0   " s o m e   t e x t " 
 
     / /   s e a r c h   b a c k w a r d   ( f r o m   t h e   c a r e t   p o s i t i o n ) ,   s e l e c t   i f   f o u n d : 
 
     s c i _ f i n d   0 x 0 2 0 1 0 0 0 0   " s o m e   t e x t " 
 
     s c i _ f i n d   N P E _ S F _ B A C K W A R D | N P E _ S F _ S E T S E L   " s o m e   t e x t "     / /   t h e   s a m e 
 
     s c i _ f i n d   " N P E _ S F _ B A C K W A R D   |   N P E _ S F _ S E T S E L "   " s o m e   t e x t "     / /   t h e   s a m e 
 
     s e t   l o c a l   f l a g s   ~   N P E _ S F _ B A C K W A R D   |   N P E _ S F _ S E T S E L 
 
     s c i _ f i n d   $ ( f l a g s )   " s o m e   t e x t "     / /   t h e   s a m e 
 
     / /   s e a r c h   f o r   a   r e g u l a r   e x p r e s s i o n   i n   t h e   e n t i r e   t e x t ,   s e l e c t   i f   f o u n d : 
 
     s e t   l o c a l   f l a g s   ~   N P E _ S F _ R E G E X P   |   N P E _ S F _ I N E N T I R E T E X T   |   N P E _ S F _ S E T S E L 
 
     s c i _ f i n d   $ ( f l a g s )   " [ 0 - 9 ] + " 
 
 R E M A R K S : 
 
     W i t h   N P E _ S F _ P R I N T A L L ,   i t   i s   p o s s i b l e   t o   a c h i e v e   a   f u n c t i o n a l i t y   s i m i l a r   t o 
 
     ( b u t   n o t   e q u a l   t o )   t h e   s t a n d a r d   " F i n d   r e s u l t "   w i n d o w . 
 
     L e t ' s   a s s u m e   y o u   w a n t   t o   f i n d   a l l   o c c u r r e n c e s   o f   " a b c " : 
 
         s c i _ f i n d   N P E _ S F _ I N E N T I R E T E X T | N P E _ S F _ P R I N T A L L   " a b c " 
 
     T h i s   w i l l   p r i n t   a l l   t h e   o c c u r r e n c e s   o f   " a b c "   i n   t h e   C o n s o l e   i n   a   f o r m   o f : 
 
         ( < l i n e > , < c o l u m n > ) 	   a b c 
 
     I n   c a s e   o f   s e a r c h i n g   w i t h   r e g u l a r   e x p r e s s i o n s ,   e . g . 
 
         s c i _ f i n d   N P E _ S F _ I N E N T I R E T E X T | N P E _ S F _ R E G E X P | N P E _ S F _ P R I N T A L L   " W M _ [ A - Z _ ] + " 
 
     t h e   r e s u l t s   w i l l   b e   p r i n t e d   i n   a   f o r m   o f : 
 
         ( < l i n e > , < c o l u m n > ) 	   < m a t c h e d _ s t r i n g > 
 
     T h e   " ( < l i n e > , < c o l u m n > ) "   p a r t   a n d   t h e   m a t c h e d   s t r i n g   p a r t   a r e   a l w a y s   s e p a r a t e d 
 
     b y   t w o   c h a r a c t e r s :   a   t a b u l a t i o n   c h a r a c t e r   ' \ t '   p l u s   a   s p a c e   c h a r a c t e r   '   ' . 
 
     S o   t h e   f o l l o w i n g   H i g h l i g h t   M a s k   c a n   b e   s p e c i f i e d   f o r   t h e   s e a r c h   r e s u l t s : 
 
         ( % L I N E % , % C H A R % ) ?   * 
 
     T h i s   w i l l   a l l o w   t o   g o   t o   t h e   o c c u r r e n c e   b y   s i m p l e   d o u b l e - c l i c k i n g . 
 
     ( A   H i g h l i g h t   M a s k   c a n   b e   s p e c i f i e d   e i t h e r   d i r e c t l y   i n   t h e   C o n s o l e   F i l t e r s 
 
     d i a l o g   o r   u s i n g   t h e   t e c h n i q u e   d e s c r i b e d   i n   " h e l p   c o n _ f i l t e r " . ) 
 
 S E E   A L S O : 
 
     s c i _ r e p l a c e ,   s c i _ s e n d m s g 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     s c i _ r e p l a c e 
 
 U S A G E : 
 
     s c i _ r e p l a c e   < f l a g s >   < f i n d _ w h a t >   < r e p l a c e _ w i t h > 
 
 D E S C R I P T I O N : 
 
     S e a r c h e s   f o r   t h e   g i v e n   s t r i n g   a c c o r d i n g   t o   t h e   s p e c i f i e d   f l a g s   a n d   r e p l a c e s   i t . 
 
     T h e   a c t u a l   b e h a v i o r   c o m p l e t e l y   d e p e n d s   o n   t h e   < f l a g s >   s p e c i f i e d . 
 
     I t   i s   r e c o m m e n d e d   t o   e n q u o t e   t h e   " f i n d _ w h a t "   a n d   " r e p l a c e _ w i t h "   s t r i n g s . 
 
     U s e   t h e   " B i t w i s e   O R "   o p e r a t o r   ' | '   t o   c o m b i n e   t h e   f l a g s . 
 
     T h e   f l a g s   c a n   b e   a   c o m b i n a t i o n   o f   t h e   f o l l o w i n g : 
 
         N P E _ S F _ M A T C H C A S E       =   0 x 0 0 0 0 0 0 0 1 
 
             -   " t e x t "   f i n d s   o n l y   " t e x t " ,   n o t   " T e x t "   o r   " T E X T " 
 
         N P E _ S F _ W H O L E W O R D       =   0 x 0 0 0 0 0 0 1 0 
 
             -   " w o r d "   f i n d s   o n l y   " w o r d " ,   n o t   " s w o r d "   o r   " w o r d s " 
 
         N P E _ S F _ W O R D S T A R T       =   0 x 0 0 0 0 0 0 2 0 
 
             -   " w o r d "   f i n d s   " w o r d "   a n d   " w o r d s " ,   n o t   " s w o r d " 
 
         N P E _ S F _ R E G E X P             =   0 x 0 0 0 0 0 1 0 0 
 
             -   s e a r c h   u s i n g   a   r e g u l a r   e x p r e s s i o n 
 
         N P E _ S F _ P O S I X               =   0 x 0 0 0 0 0 2 0 0 
 
             -   s e a r c h   u s i n g   a   P O S I X - c o m p a t i b l e   r e g u l a r   e x p r e s s i o n 
 
         N P E _ S F _ C X X 1 1 R E G E X     =   0 x 0 0 0 0 0 4 0 0 
 
             -   s e a r c h   u s i n g   a   C + + 1 1   r e g u l a r   e x p r e s s i o n 
 
         N P E _ S F _ B A C K W A R D         =   0 x 0 0 0 1 0 0 0 0 
 
             -   s e a r c h   b a c k w a r d   ( f r o m   t h e   b o t t o m   t o   t h e   t o p ) 
 
         N P E _ S F _ N E X T                 =   0 x 0 0 0 2 0 0 0 0 
 
             -   s e a r c h   f r o m   c u r r e n t _ p o s i t i o n   +   1 
 
         N P E _ S F _ I N S E L E C T I O N   =   0 x 0 0 1 0 0 0 0 0 
 
             -   s e a r c h   o n l y   i n   t h e   s e l e c t e d   t e x t 
 
         N P E _ S F _ I N E N T I R E T E X T   =   0 x 0 0 2 0 0 0 0 0 
 
             -   s e a r c h   i n   t h e   e n t i r e   t e x t ,   n o t   o n l y   f r o m   t h e   c u r r e n t   p o s i t i o n 
 
         N P E _ S F _ S E T P O S             =   0 x 0 1 0 0 0 0 0 0 
 
             -   m o v e   t h e   c a r e t   t o   t h e   p o s i t i o n   o f   t h e   o c c u r r e n c e   f o u n d 
 
         N P E _ S F _ S E T S E L             =   0 x 0 2 0 0 0 0 0 0 
 
             -   m o v e   t h e   c a r e t   +   s e l e c t   t h e   o c c u r r e n c e   f o u n d 
 
         N P E _ S F _ R E P L A C E A L L     =   0 x 1 0 0 0 0 0 0 0     / /   o n l y   f o r   s c i _ r e p l a c e 
 
             -   r e p l a c e   a l l   t h e   o c c u r r e n c e s   f r o m   t h e   c u r r e n t   p o s   t o   t h e   e n d 
 
         N P E _ S F _ P R I N T A L L         =   0 x 2 0 0 0 0 0 0 0 
 
             -   p r i n t   a l l   t h e   o c c u r r e n c e s   f r o m   t h e   c u r r e n t   p o s   t o   t h e   e n d 
 
     T h i s   c o m m a n d   s e t s   t h e   f o l l o w i n g   l o c a l   v a r i a b l e s : 
 
         $ ( M S G _ R E S U L T )   -   t h e   p o s i t i o n   o f   t h e   o c c u r r e n c e   f o u n d ,   o r   - 1 
 
         $ ( M S G _ W P A R A M )   -   < f i n d _ w h a t > ' s   l e n g t h   i n   S c i n t i l l a ' s   c h a r s   ( * ) 
 
         $ ( M S G _ L P A R A M )   -   < r e p l a c e _ w i t h > ' s   l e n g t h   i n   S c i n t i l l a ' s   c h a r s   ( * ) 
 
         *   i n   c a s e   o f   r e g u l a r   e x p r e s s i o n ,   i t   i s   t h e   l e n g t h   o f   t h e   m a t c h e d   s t r i n g 
 
 E X A M P L E S : 
 
     / /   r e p l a c e   t h e   f i r s t   o c c u r r e n c e   o f   " s o m e   t e x t "   w i t h   n o t h i n g : 
 
     s c i _ r e p l a c e   0   " s o m e   t e x t " 
 
     / /   r e p l a c e   a l l   o c c u r r e n c e s   o f   " s o m e   t e x t "   w i t h   n o t h i n g : 
 
     s c i _ r e p l a c e   N P E _ S F _ I N E N T I R E T E X T | N P E _ S F _ R E P L A C E A L L   " s o m e   t e x t " 
 
     / /   r e p l a c e   a l l   o c c u r r e n c e s   o f   " s o m e   t e x t "   w i t h   " o t h e r   t e x t " : 
 
     s c i _ r e p l a c e   N P E _ S F _ I N E N T I R E T E X T | N P E _ S F _ R E P L A C E A L L   " s o m e   t e x t "   " o t h e r   t e x t " 
 
     / /   r e p l a c e   a l l   o c c u r r e n c e s   i n   t h e   s e l e c t i o n ,   s e a r c h i n g   b a c k w a r d : 
 
     s e t   l o c a l   f l a g s   ~   N P E _ S F _ I N S E L E C T I O N   |   N P E _ S F _ R E P L A C E A L L   |   N P E _ S F _ B A C K W A R D 
 
     s c i _ r e p l a c e   $ ( f l a g s )   " s o m e   t e x t "   " o t h e r   t e x t " 
 
     / /   r e p l a c e   u s i n g   a   r e g u l a r   e x p r e s s i o n ,   s e a r c h i n g   b a c k w a r d : 
 
     s e t   l o c a l   f l a g s   ~   N P E _ S F _ B A C K W A R D   |   N P E _ S F _ R E G E X P 
 
     s c i _ r e p l a c e   $ ( f l a g s )   " ( [ a - z ] + ) - ( [ a - z ] + ) "   " \ 2 - \ 1 " 
 
     / /   t h e   s a m e : 
 
     s c i _ r e p l a c e   0 x 0 0 0 1 0 1 0 0   " ( [ a - z ] + ) - ( [ a - z ] + ) "   " \ 2 - \ 1 " 
 
     / /   t h e   s a m e : 
 
     s c i _ r e p l a c e   N P E _ S F _ B A C K W A R D | N P E _ S F _ R E G E X P   " ( [ a - z ] + ) - ( [ a - z ] + ) "   " \ 2 - \ 1 " 
 
     / /   r e p l a c e   u s i n g   a   r e g u l a r   e x p r e s s i o n ,   s e l e c t   i f   f o u n d : 
 
     s c i _ r e p l a c e   N P E _ S F _ R E G E X P | N P E _ S F _ S E T S E L   " ( [ a - z ] + ) - ( [ a - z ] + ) "   " \ 2 - \ 1 " 
 
 R E M A R K S : 
 
     C o m b i n i n g   N P E _ S F _ R E P L A C E A L L   w i t h   N P E _ S F _ P R I N T A L L ,   i t   i s   p o s s i b l e   t o   s e e   a l l 
 
     t h e   r e p l a c e d   o c c u r r e n c e s   i n   t h e   C o n s o l e   ( s e e   a l s o :   s c i _ f i n d ) . 
 
     U s i n g   N P E _ S F _ P R I N T A L L   a l o n e ,   w i t h o u t   N P E _ S F _ R E P L A C E A L L ,   i t   i s   p o s s i b l e   t o   s e e 
 
     a l l   t h e   f o u n d   o c c u r r e n c e s   i n   t h e   C o n s o l e ,   w i t h   o n l y   t h e   f i r s t   o c c u r r e n c e 
 
     r e p l a c e d . 
 
     T h e   c o m b i n a t i o n   o f   N P E _ S F _ R E P L A C E A L L | N P E _ S F _ P R I N T A L L | N P E _ S F _ B A C K W A R D   w i l l 
 
     m o s t   l i k e l y   l e a d   t o   i n c o r r e c t   c h a r a c t e r   p o s i t i o n s   p r i n t e d   i n   t h e   C o n s o l e . 
 
     W h y ?   B e c a u s e   e a c h   r e p l a c e m e n t   w i t h   a   s t r i n g   o f   d i f f e r e n t   l e n g t h   c h a n g e s   t h e 
 
     l e n g t h   o f   t h e   e n t i r e   t e x t .   A n d   w h i l e   t h e   r e p l a c e m e n t s   a r e   b e i n g   d o n e   f r o m 
 
     t h e   b o t t o m   t o   t h e   t o p ,   e a c h   n e w   r e p l a c e m e n t   c h a n g e s   t h e   o f f s e t s   o f   a l l   t h e 
 
     s t r i n g s   b e l o w   i t ,   a f f e c t i n g   t h e   p o s i t i o n s   o f   t h e   o c c u r r e n c e s   t h a t   h a v e 
 
     a l r e a d y   b e e n   p r i n t e d   i n   t h e   C o n s o l e .   ( A n d   y e s ,   i t   p r o v e s   t h a t   w h e n   y o u   t e l l 
 
     s c i _ r e p l a c e   t o   r e p l a c e   i n   t h e   b a c k w a r d   d i r e c t i o n ,   i t   r e a l l y   d o e s   i t   i n   t h e 
 
     b a c k w a r d   d i r e c t i o n . ) 
 
 S E E   A L S O : 
 
     s c i _ f i n d ,   s c i _ s e n d m s g 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 D E S C R I P T I O N :     f i l e   m a s k 
 
 U S A G E : 
 
     F i l e   m a s k s   a r e   u s e d   b y   s u c h   c o m m a n d s   a s   D I R   a n d   N P P _ O P E N 
 
 D E S C R I P T I O N : 
 
     T h e   f i l e   m a s k   i n   N p p E x e c   i s   a n   o r t h o g r a p h i c a l   c o n s t r u c t i o n   w h e r e 
 
         ?   m e a n s   a n y   s i n g l e   c h a r a c t e r   a n d 
 
         *   m e a n s   a n y   0   o r   m o r e   c h a r a c t e r s 
 
     r e g a r d l e s s   o f   s u c h   c o n c e p t s   a s   f i l e   n a m e   o r   f i l e   e x t e n s i o n . 
 
     T h u s ,   * . *   i n   N p p E x e c   D O E S   N O T   m a t c h   a n y   f i l e   o r   d i r e c t o r y   n a m e   - 
 
     i t   m a t c h e s   a n y   s t r i n g   w h i c h   c o n t a i n s   ' . ' 
 
     A l s o ,   * t x * . *   d o e s   n o t   m a t c h   " f i l e . t x t "   b e c a u s e   " t x "   m u s t   b e 
 
     l o c a t e d   B E F O R E   ' . '   a n d   n o t   A F T E R   i t . 
 
 E X A M P L E S : 
 
     d i r   * . c p p                   / /   p r i n t s   a l l   * . c p p   f i l e s   i n   c u r r e n t   d i r e c t o r y 
 
     n p p _ o p e n   * d l g * . *     / /   o p e n s   a l l   f i l e s   w h i c h   c o n t a i n   " d l g "   a n d   ' . '   i n   i t s   n a m e 
 
 S E E   A L S O : 
 
     d i r ,   n p p _ o p e n 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     s e t / u n s e t 
 
 U S A G E : 
 
     1 .     s e t 
 
     2 .     s e t   < v a r > 
 
     3 .     s e t   < v a r >   =   < v a l u e > 
 
             s e t   $ ( < v a r > )   =   < v a l u e > 
 
     4 .     s e t   < v a r >   ~   < m a t h   e x p r e s s i o n > 
 
     5 a .   s e t   < v a r >   ~   s t r l e n   < s t r i n g > 
 
     5 b .   s e t   < v a r >   ~   s t r l e n u t f 8   < s t r i n g > 
 
     5 c .   s e t   < v a r >   ~   s t r l e n s c i   < s t r i n g > 
 
     5 d .   s e t   < v a r >   ~   s t r u p p e r   < s t r i n g > 
 
     5 e .   s e t   < v a r >   ~   s t r l o w e r   < s t r i n g > 
 
     5 f .   s e t   < v a r >   ~   s u b s t r   < p o s >   < l e n >   < s t r i n g > 
 
     5 g .   s e t   < v a r >   ~   s t r f i n d   < s t r i n g >   < s f i n d > 
 
     5 h .   s e t   < v a r >   ~   s t r r f i n d   < s t r i n g >   < s f i n d > 
 
     5 i .   s e t   < v a r >   ~   s t r r e p l a c e   < s t r i n g >   < s f i n d >   < s r e p l a c e > 
 
     5 j .   s e t   < v a r >   ~   s t r q u o t e   < s t r i n g > 
 
     5 k .   s e t   < v a r >   ~   s t r u n q u o t e   < s t r i n g > 
 
     5 l .   s e t   < v a r >   ~   s t r e s c a p e   < s t r i n g > 
 
     5 m .   s e t   < v a r >   ~   s t r u n e s c a p e   < s t r i n g > 
 
     5 n .   s e t   < v a r >   ~   s t r e x p a n d   < s t r i n g > 
 
     5 o .   s e t   < v a r >   ~   n o r m p a t h   < p a t h > 
 
     5 p .   s e t   < v a r >   ~   s t r f r o m h e x   < h e x s t r i n g > 
 
     5 q .   s e t   < v a r >   ~   s t r t o h e x   < s t r i n g > 
 
     5 r .   s e t   < v a r >   ~   c h r   < n > 
 
     5 s .   s e t   < v a r >   ~   o r d   < c > 
 
     5 t .   s e t   < v a r >   ~   o r d x   < c > 
 
     6 .     s e t   l o c a l 
 
             s e t   l o c a l   < v a r > 
 
             s e t   l o c a l   < v a r >   =   . . . 
 
             s e t   l o c a l   < v a r >   ~   . . . 
 
     7 .     u n s e t   < v a r > 
 
             u n s e t   < v a r >   =   < v a l u e > 
 
     8 .     u n s e t   l o c a l   < v a r > 
 
 D E S C R I P T I O N : 
 
     1 .     S h o w s   a l l   u s e r ' s   v a r i a b l e s   ( " s e t "   w i t h o u t   p a r a m e t e r s ) 
 
     2 .     S h o w s   t h e   v a l u e   o f   u s e r ' s   v a r i a b l e   ( " s e t "   w i t h o u t   " = " ) 
 
     3 .     S e t s   t h e   v a l u e   o f   u s e r ' s   v a r i a b l e   ( " s e t   < v a r >   =   < v a l u e > " ) 
 
     4 .     C a l c u l a t e s   t h e   m a t h   e x p r e s s i o n   ( " s e t   < v a r >   ~   < m a t h   e x p r > " ) 
 
     5 a .   C a l c u l a t e s   t h e   s t r i n g   l e n g t h   ( " s e t   < v a r >   ~   s t r l e n   < s t r i n g > " ) 
 
     5 b .   C a l c u l a t e s   t h e   U T F - 8   s t r i n g   l e n g t h   ( " s e t   < v a r >   ~   s t r l e n u t f 8   < s > " ) 
 
     5 c .   C a l c u l a t e s   S c i n t i l l a ' s   s t r i n g   l e n g t h   ( " s e t   < v a r >   ~   s t r l e n s c i   < s > " ) 
 
             ( d e p e n d i n g   o n   S c i n t i l l a ' s   e n c o d i n g ,   e q u a l s   t o   s t r l e n   o r   s t r l e n u t f 8 ) 
 
     5 d .   R e t u r n s   t h e   s t r i n g   i n   u p p e r   c a s e   ( " s e t   < v a r >   ~   s t r u p p e r   < s > " ) 
 
     5 e .   R e t u r n s   t h e   s t r i n g   i n   l o w e r   c a s e   ( " s e t   < v a r >   ~   s t r l o w e r   < s > " ) 
 
     5 f .   R e t u r n s   t h e   s u b s t r i n g   ( " s u b s t r   < p o s >   < l e n >   < s > " ) 
 
     5 g .   R e t u r n s   t h e   p o s i t i o n   o f   f i r s t   < s f i n d >   i n   < s t r i n g > 
 
     5 h .   R e t u r n s   t h e   p o s i t i o n   o f   l a s t   < s f i n d >   i n   < s t r i n g > 
 
     5 i .   R e p l a c e s   a l l   < s f i n d >   w i t h   < s r e p l a c e >   i n   < s t r i n g > 
 
     5 j .   R e t u r n s   t h e   s t r i n g   s u r r o u n d e d   w i t h   " "   q u o t e s 
 
     5 k .   R e m o v e s   t h e   s u r r o u n d i n g   " "   q u o t e s 
 
     5 l .   S i m p l e   c h a r a c t e r   e s c a p i n g :   ' \ '   - >   ' \ \ ' ,   ' < T A B > '   - >   ' \ t ' , 
 
             ' < C R > '   - >   ' \ r ' ,   ' < L F > '   - >   ' \ n ' ,   ' " '   - >   ' \ " ' 
 
     5 m .   S i m p l e   c h a r a c t e r   u n e s c a p i n g :   ' \ \ '   - >   ' \ ' ,   ' \ t '   - >   ' < T A B > ' , 
 
             ' \ r '   - >   ' < C R > ' ,   ' \ n '   - >   ' < L F > ' ,   ' \ ? '   - >   ' ? ' 
 
     5 n .   E x p a n d s   a l l   $ ( s u b )   v a l u e s   w i t h i n   t h e   < s t r i n g > 
 
     5 o .   R e t u r n s   a   n o r m a l i z e d   p a t h 
 
     5 p .   R e t u r n s   a   s t r i n g   f r o m   t h e   < h e x s t r i n g > 
 
     5 q .   R e t u r n s   a   h e x - s t r i n g   f r o m   t h e   < s t r i n g > 
 
     5 r .   R e t u r n s   a   c h a r a c t e r   f r o m   a   c h a r a c t e r   c o d e   < n > 
 
     5 s .   R e t u r n s   a   d e c i m a l   c h a r a c t e r   c o d e   o f   a   c h a r a c t e r   < c > 
 
     5 t .   R e t u r n s   a   h e x a d e c i m a l   c h a r a c t e r   c o d e   o f   a   c h a r a c t e r   < c > 
 
     6 .     S h o w s / s e t s   t h e   v a l u e   o f   l o c a l   v a r i a b l e   ( " s e t   l o c a l   < v a r >   . . . " ) 
 
     7 .     R e m o v e s   t h e   v a r i a b l e   < v a r >   ( " u n s e t   < v a r > " ) 
 
     8 .     R e m o v e s   t h e   l o c a l   v a r i a b l e   < v a r >   ( " u n s e t   l o c a l   < v a r > " ) 
 
 E X A M P L E S : 
 
     s e t   p   =   C : \ P r o g r a m   F i l e s 
 
     d i r   $ ( p ) \ *     / /   t h e   s a m e   a s   d i r   C : \ P r o g r a m   F i l e s \ * 
 
     u n s e t   p           / /   r e m o v e s   t h e   v a r i a b l e   p 
 
     / /   s e t   v s .   s e t   l o c a l : 
 
     s e t   x   =   1 0               / /   1 0 :   g l o b a l   x 
 
     s e t   l o c a l   x   =   2 0   / /   2 0 :   l o c a l   x 
 
     e c h o   $ ( x )                 / /   2 0 :   s u b s t i t u t e s   t h e   o v e r r i d d e n   ( l o c a l )   x 
 
     s e t   x                         / /   1 0 :   p r i n t s   g l o b a l   x 
 
     s e t   l o c a l   x             / /   2 0 :   p r i n t s   l o c a l   x 
 
     u n s e t   l o c a l   x         / /   2 0 :   d e l e t e s   l o c a l   x 
 
     e c h o   $ ( x )                 / /   1 0 :   s u b s t i t u t e s   t h e   g l o b a l   x 
 
     / /   i n d i r e c t   v a r i a b l e   r e f e r e n c e : 
 
     s e t   l o c a l   a   =   1 2 3 
 
     s e t   l o c a l   b   =   a 
 
     e c h o   $ ( $ ( b ) )                       / /   p r i n t s   1 2 3   :   $ ( $ ( b ) )   =   $ ( a )   =   1 2 3 
 
     s e t   l o c a l   c   =   $ ( $ ( b ) )     / /   $ ( c )   =   1 2 3   :   $ ( $ ( b ) )   =   $ ( a )   =   1 2 3 
 
     u n s e t   l o c a l   $ ( $ ( b ) )         / /   d e l e t e s   $ ( a ) 
 
     / /   c a l c u l a t i o n s : 
 
     s e t   a n s   ~   1   +   2 * ( 3   +   4 )   -   0 x 5     / /   c a l c u l a t e s   t h e   e x p r e s s i o n 
 
     s e t   a n s   ~   0 x 0 0 1   |   0 x 0 1 0   |   0 x 1 0 0     / /   c a l c u l a t e s   t h e   e x p r e s s i o n 
 
     s e t   a n s   ~   h e x ( 0 x 0 0 1   |   0 x 0 1 0   |   0 x 1 0 0 )     / /   c a l c u l a t e s   a s   h e x a d e c i m a l 
 
     / /   s t r l e n : 
 
     s e t   n   ~   s t r l e n       A B C   D       / /   s e t s   n = 5   ( s k i p p i n g   l e a d i n g   &   t r a i l i n g   s p a c e s ) 
 
     s e t   n   ~   s t r l e n   "     A B C   "     / /   s e t s   n = 8   ( i n c l u d i n g   s p a c e s   &   d o u b l e   q u o t e s ) 
 
     / /   i n   c a s e   o f   n o n - L a t i n   c h a r a c t e r s ,   s t r l e n u t f 8   m a y   d i f f e r   f r o m   s t r l e n : 
 
     s e t   n   ~   s t r l e n u t f 8   @825B    / /   s e t s   n = 1 2   ( n u m b e r   o f   U T F - 8   b y t e s ) 
 
     s e t   n   ~   s t r l e n s c i   @825B    / /   s e t s   n = 6   f o r   S c i n t i l l a   w i t h   m u l t i b y t e   e n c o d i n g 
 
     s e t   n   ~   s t r l e n s c i   @825B    / /   s e t s   n = 1 2   f o r   S c i n t i l l a   w i t h   U T F - 8   e n c o d i n g 
 
     / /   s t r u p p e r / s t r l o w e r : 
 
     s e t   s   =   T e x t 
 
     s e t   t   =   $ ( s )                       / /   t   =   T e x t 
 
     s e t   t   ~   s t r u p p e r   $ ( s )     / /   t   =   T E X T 
 
     s e t   t   ~   s t r l o w e r   $ ( s )     / /   t   =   t e x t 
 
     / /   s u b s t r : 
 
     s e t   s   ~   s u b s t r   0   3     a b c d e     / /   a b c   ( 3   c h a r a c t e r s   f r o m   p o s i t i o n   0 ) 
 
     s e t   s   ~   s u b s t r   2   2     a b c d e     / /   c d   ( 2   c h a r a c t e r s   f r o m   p o s i t i o n   2 ) 
 
     s e t   s   ~   s u b s t r   3   -     a b c d e     / /   d e   ( s u b s t r i n g   f r o m   p o s i t i o n   3   t o   t h e   e n d ) 
 
     s e t   s   ~   s u b s t r   1   - 2   a b c d e     / /   b c   ( s u b s t r i n g   f r o m   p o s i t i o n   1   t o   l e n g t h - 2 ) 
 
     s e t   s   ~   s u b s t r   - 3   -   a b c d e     / /   c d e   ( s u b s t r i n g   f r o m   p o s i t i o n   l e n g t h - 3   t o   t h e   e n d ) 
 
     s e t   s   ~   s u b s t r   - 2   1   a b c d e     / /   d   ( 1   c h a r a c t e r   f r o m   p o s i t i o n   l e n g t h - 2 ) 
 
     s e t   s   ~   s u b s t r   - 3   - 2   a b c d e   / /   c   ( s u b s t r i n g   f r o m   p o s i t i o n   l e n g t h - 3   t o   l e n g t h - 2 ) 
 
     s e t   s   =   a b c d e 
 
     s e t   t   ~   s u b s t r   1   3   $ ( s )         / /   b c d   ( 3   c h a r a c t e r s   f r o m   p o s i t i o n   1 ) 
 
     / /   s t r f i n d / s t r r f i n d 
 
     / /   *   q u o t e s   a r e   n o t   t r e a t e d   a s   a   p a r t   o f   a   s t r i n g   i t s e l f 
 
     s e t   n   ~   s t r f i n d   " H e l l o   w o r l d "   H e l l o     / /   r e t u r n s   0 
 
     s e t   n   ~   s t r f i n d   " H e l l o   w o r l d "   " o "         / /   r e t u r n s   4   -   " o "   i n   " H e l l o " 
 
     s e t   n   ~   s t r r f i n d   " H e l l o   w o r l d "   o           / /   r e t u r n s   7   -   " o "   i n   " w o r l d " 
 
     s e t   n   ~   s t r r f i n d   " H e l l o   w o r l d "   x           / /   r e t u r n s   - 1   -   " x "   n o t   f o u n d 
 
     s e t   n   ~   s t r f i n d   " H e l l o   w o r l d "   " o   y "     / /   r e t u r n s   - 1   -   " o   y "   n o t   f o u n d 
 
     s e t   s   =   a b c d 
 
     s e t   n   ~   s t r f i n d   " $ ( s ) "   c d                         / /   r e t u r n s   2 
 
     / /   s t r r e p l a c e 
 
     / /   *   q u o t e s   a r e   n o t   t r e a t e d   a s   a   p a r t   o f   a   s t r i n g   i t s e l f 
 
     s e t   s   ~   s t r r e p l a c e   " H e l l o   w o r l d "   " o "   " 0 "   / /   H e l l 0   w 0 r l d         ( " o "   - >   " 0 " ) 
 
     s e t   s   ~   s t r r e p l a c e   " $ ( s ) "   l   1                         / /   H e 1 1 0   w 0 r 1 d         ( " l "   - >   " 1 " ) 
 
     s e t   s   ~   s t r r e p l a c e   " $ ( s ) "   1   " y   "                   / /   H e y   y   0   w 0 r y   d   ( " 1 "   - >   " y   " ) 
 
     s e t   s   ~   s t r r e p l a c e   " q u e e n - b e e "   e e   " "           / /   q u n - b                     ( " e e "   - >   " " ) 
 
     / /   s t r q u o t e 
 
     s e t   s   ~   s t r q u o t e   a   b   c                 / /   " a   b   c " 
 
     s e t   s   ~   s t r q u o t e   " a   b   c "             / /   " a   b   c " 
 
     / /   s t r u n q u o t e 
 
     s e t   s   ~   s t r u n q u o t e   " a   b   c "         / /   a   b   c 
 
     s e t   s   ~   s t r u n q u o t e   a   b   c             / /   a   b   c 
 
     / /   s t r e s c a p e   &   s t r u n e s c a p e 
 
     s e t   l o c a l   T A B   ~   c h r   0 x 0 9     / /   < T A B >   =   ' \ t ' 
 
     s e t   l o c a l   L F   ~   c h r   0 x 0 A     / /   < L F >   =   ' \ n ' 
 
     s e t   l o c a l   s   =   C : \ A $ ( T A B ) b \ C $ ( L F ) d \ E f     / /   C : \ A < T A B > b \ C < L F > d \ E f 
 
     s e t   l o c a l   t   ~   s t r e s c a p e   " $ ( s ) "     / /   \ " C : \ \ A \ t b \ \ C \ n d \ \ E f \ " 
 
     s e t   l o c a l   s 2   ~   s t r u n e s c a p e   $ ( t ) \ x     / /   " C : \ A < T A B > b \ C < L F > d \ E f " x 
 
     s e t   l o c a l   s 3   ~   s t r u n e s c a p e   $ ( s 2 )     / /   " C : A < T A B > b C < L F > d E f " x 
 
     / /   s t r e x p a n d 
 
     s e t   l o c a l   x   =   1 2 3 
 
     s e t   l o c a l   y   =   $ 
 
     s e t   l o c a l   z   ~   s t r e x p a n d   $ ( y ) ( x )   / /   $ ( y ) ( x )   - >   $ ( x )   - >   1 2 3 
 
     c l i p _ s e t t e x t   $ ( y ) ( x )   / /   n o w   t h e   c l i p b o a r d   c o n t a i n s   " $ ( x ) " 
 
     s e t   l o c a l   c   ~   s t r e x p a n d   $ ( C L I P B O A R D _ T E X T )   / /   $ ( x )   - >   1 2 3 
 
     / /   n o r m p a t h 
 
     s e t   s   ~   n o r m p a t h   C : \ A \ . \ B \ X \ . . \ C     / /   C : \ A \ B \ C 
 
     s e t   s   ~   n o r m p a t h   " \ \ A \ B \ . . \ . . \ C "     / /   " \ \ C " 
 
     / /   s t r f r o m h e x   ( u n i c o d e   v e r s i o n ) 
 
     s e t   s   ~   s t r f r o m h e x   0 D   0 0   0 A   0 0                       / /   < C R > < L F >   =   \ r \ n   i n   C / C + + 
 
     s e t   s   ~   s t r f r o m h e x   " a b "   0 9   0 0   " c "   0 A   0 0     / /   a b < T A B > c < L F >   =   a b \ t c \ n   i n   C / C + + 
 
     / /   s t r t o h e x   ( u n i c o d e   v e r s i o n ) 
 
     s e t   s   ~   s t r t o h e x   a b c 1 2 3       / /   6 1   0 0   6 2   0 0   6 3   0 0   3 1   0 0   3 2   0 0   3 3   0 0 
 
     s e t   s   ~   s t r t o h e x   " a b   1 2 "     / /   6 1   0 0   6 2   0 0   2 0   0 0   3 1   0 0   3 2   0 0 
 
     s e t   s   ~   s t r t o h e x   @825B      / /   1 F   0 4   4 0   0 4   3 8   0 4   3 2   0 4   3 5   0 4   4 2   0 4 
 
     / /   c h r 
 
     s e t   c   ~   c h r   0 x 7 1         / /   q 
 
     s e t   c   ~   c h r   1 1 3           / /   q 
 
     s e t   c   ~   c h r   0 x 0 4 1 6     / /   
 
     / /   o r d 
 
     s e t   n   ~   o r d   /               / /   4 7 
 
     s e t   n   ~   o r d   q               / /   1 1 3 
 
     s e t   n   ~   o r d   9              / /   1 0 8 1 
 
     s e t   n   ~   o r d   "   "           / /   3 2 
 
     s e t   n   ~   o r d   " z "           / /   1 2 2 
 
     / /   o r d x 
 
     s e t   n   ~   o r d x   /             / /   0 x 2 F 
 
     s e t   n   ~   o r d x   q             / /   0 x 7 1 
 
     s e t   n   ~   o r d x               / /   0 x 0 4 1 6 
 
     s e t   n   ~   o r d x   "   "         / /   0 x 2 0 
 
     s e t   n   ~   o r d x   " z "         / /   0 x 7 A 
 
 R E M A R K S : 
 
     U s e r ' s   v a r i a b l e s   h a v e   t h e   l o w e s t   p r i o r i t y ,   s o   t h e y   c a n ' t   o v e r r i d e 
 
     o t h e r   ( p r e d e f i n e d )   v a r i a b l e s .   T h u s ,   y o u   c a n   s e t   y o u r   o w n   v a r i a b l e s 
 
     $ ( F I L E _ N A M E ) ,   $ ( A R G V )   a n d   s o   o n ,   b u t   t h e i r   v a l u e s   w i l l   n o t   b e 
 
     a v a i l a b l e   b e c a u s e   o f   p r e d e f i n e d   v a r i a b l e s   w i t h   t h e   s a m e   n a m e . 
 
     T h e s e   v a r i a b l e s   a r e   i n t e r n a l   v a r i a b l e s   o f   N p p E x e c ,   u n l i k e 
 
     e n v i r o n m e n t   v a r i a b l e s   w h i c h   c a n   b e   s e t   u s i n g   E N V _ S E T . 
 
     N p p E x e c   u s e s   F u n c t i o n   P a r s e r   ( f p a r s e r )   t o   c a l c u l a t e   t h e   m a t h 
 
     e x p r e s s i o n   g i v e n   a s   " s e t   < v a r >   ~   < m a t h   e x p r e s s i o n > " . 
 
     T h e   m a t h   e x p r e s s i o n   c a n   c o n t a i n   h e x   n u m b e r s   w i t h   l e a d i n g   " 0 x " 
 
     ( e . g .   s e t   a n s   ~   0 x 0 F   +   0 x 1 0 A   -   0 x B ) . 
 
     T h e   f o l l o w i n g   c o n s t a n t s   a r e   h a r d c o d e d :   W M _ U S E R ,   N P P M S G . 
 
     F o r   m o r e   d e t a i l s   a b o u t   s u p p o r t e d   f u n c t i o n s ,   s e e   " f p a r s e r . h t m l " . 
 
     Y o u   c a n   u s e   N P E _ C M D A L I A S   t o   d e f i n e   a   s h o r t   a l i a s   t o   t h e   b u i l t - i n 
 
     c a l c u l a t o r : 
 
         n p e _ c m d a l i a s   =   =   s e t   a n s   ~     / /   " = "   - >   " s e t   a n s   ~ " 
 
         =   1   +   2 / 3   +   4 / 5     / /   u s i n g   t h e   a l i a s   f o r   c a l c u l a t i o n s 
 
     L o c a l   v a r i a b l e s   ( " s e t   l o c a l   < v a r > " )   l i v e   j u s t   w i t h i n   a   s c r i p t 
 
     w h e r e   t h e y   w e r e   d e c l a r e d .   W h e n   t h e   s c r i p t   e n d s ,   a l l   i t s   l o c a l 
 
     v a r i a b l e s   a r e   a u t o m a t i c a l l y   d e l e t e d . 
 
     W i t h i n   a   s c r i p t ,   a   l o c a l   v a r i a b l e   o v e r r i d e s   a   g l o b a l   v a r i a b l e 
 
     w i t h   t h e   s a m e   n a m e .   E a c h   s c r i p t   m a y   h a v e   i t s   o w n   l o c a l   v a r i a b l e s 
 
     t h a t   a r e   n o t   i n h e r i t e d   b y   N P P _ E X E C - e d   s c r i p t s . 
 
     T h e   s a m e   a p p l i e s   t o   l o c a l   v a r i a b l e s   c r e a t e d   d i r e c t l y   i n   N p p E x e c ' s 
 
     C o n s o l e   -   t h e s e   l o c a l   v a r i a b l e s   l i v e   o n l y   i n   N p p E x e c ' s   C o n s o l e 
 
     a n d   a r e   n o t   v i s i b l e   i n   N p p E x e c ' s   s c r i p t s . 
 
 S E E   A L S O : 
 
     e n v _ s e t / e n v _ u n s e t ,   i f 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     e n v _ s e t / e n v _ u n s e t 
 
 U S A G E : 
 
     e n v _ s e t   < v a r > 
 
     e n v _ s e t   < v a r >   =   < v a l u e > 
 
     e n v _ s e t   l o c a l   < v a r >   =   < v a l u e > 
 
     e n v _ u n s e t   < v a r > 
 
 D E S C R I P T I O N : 
 
     1 .   S h o w s   t h e   v a l u e   o f   e n v i r o n m e n t   v a r i a b l e   ( " e n v _ s e t "   w i t h o u t   " = " ) 
 
     2 .   S e t s   t h e   v a l u e   o f   e n v i r o n m e n t   v a r i a b l e   ( " e n v _ s e t   < v a r >   =   < v a l u e > " ) 
 
     3 .   S e t s   t h e   v a l u e   o f   e n v i r o n m e n t   v a r i a b l e   l o c a l l y   ( w i t h   " l o c a l "   s p e c i f i e d ) 
 
     4 .   R e m o v e s / r e s t o r e s   t h e   e n v i r o n m e n t   v a r i a b l e   < v a r >   ( " e n v _ u n s e t   < v a r > " ) 
 
     W h e n   " l o c a l "   i s   s p e c i f i e d ,   t h e   c h a n g e s   a r e   a p p l i e d   l o c a l l y   t o   t h e   c u r r e n t 
 
     N p p E x e c ' s   s c r i p t   a n d   a r e   r e v e r t e d   b a c k   w h e n   t h e   c u r r e n t   s c r i p t   e n d s . 
 
 E X A M P L E S : 
 
     e n v _ s e t   N P P H O M E   =   $ ( N P P _ D I R E C T O R Y )     / /   n e w   e n v i r o n m e n t   v a r i a b l e :   N P P H O M E 
 
     e n v _ s e t   P A T H   =   $ ( S Y S . N P P H O M E ) ; $ ( S Y S . P A T H )     / /   m o d i f y i n g   t h e   P A T H   v a r i a b l e 
 
     n p p _ r u n   r e a d m e . t x t     / /   o p e n i n g   " r e a d m e . t x t "   f r o m   N o t e p a d + + ' e s   f o l d e r 
 
                                             / /   ( N P P H O M E   i s   t h e   f i r s t   p a t h   i n   t h e   P A T H   v a r i a b l e ) 
 
     e n v _ u n s e t   N P P H O M E     / /   r e m o v i n g   t h e   e n v i r o n m e n t   v a r i a b l e   N P P H O M E 
 
     e n v _ u n s e t   P A T H           / /   r e s t o r i n g   i n i t i a l   v a l u e   o f   P A T H 
 
     e n v _ s e t   l o c a l   P A T H   =   C : \ t o o l s ; $ ( S Y S . P A T H )     / /   h a s   l o c a l   e f f e c t 
 
 R E M A R K S : 
 
     U n l i k e   s e t / u n s e t ,   t h e s e   c o m m a n d s   d e a l   w i t h   N o t e p a d + + ' e s   e n v i r o n m e n t   v a r s 
 
     w h i c h   a r e   i n h e r i t e d   b y   c h i l d   p r o c e s s e s   ( p r o g r a m s ,   t o o l s )   s t a r t e d   f r o m 
 
     N p p E x e c   o r   N o t e p a d + + ' e s   " R u n . . . "   m e n u . 
 
     N p p E x e c   c a n   u s e   t h e   v a l u e s   o f   e n v i r o n m e n t   v a r i a b l e s   i n   a   f o r m   o f   $ ( S Y S . < v a r > ) . 
 
     F o r   e x a m p l e : 
 
         e n v _ s e t   N P P H O M E   =   $ ( N P P _ D I R E C T O R Y )     / /   n e w   e n v i r o n m e n t   v a r i a b l e :   N P P H O M E 
 
         e c h o   $ ( S Y S . N P P H O M E )     / /   p r i n t   t h e   v a l u e   o f   N P P H O M E 
 
     N p p E x e c   d o e s   n o t   u n d e r s t a n d   s u c h   f o r m   o f   e n v i r o n m e n t   v a r i a b l e   a s   % < v a r > % . 
 
     I . e .   y o u   c a n   t y p e     " e n v _ s e t   P A T H   =   C : \ t o o l s ; $ ( S Y S . P A T H ) " , 
 
     b u t   n o t     " e n v _ s e t   P A T H   =   C : \ t o o l s ; % P A T H % " 
 
     b e c a u s e   N p p E x e c   d o e s   n o t   s u p p o r t   s u c h   d e c l a r a t i o n   a s   % P A T H % . 
 
     Y o u   c a n   u s e   a   v a l u e   o f   o t h e r   v a r i a b l e   a s   a n   e n v i r o n m e n t   v a r i a b l e   n a m e : 
 
         s e t   a   =   P A T H     / /   v a l u e   o f   ' a '   i s   a   s t r i n g   " P A T H " 
 
         e n v _ s e t   $ ( a )   =   C : \ t o o l s     / /   e n v .   v a r i a b l e   P A T H   b e c o m e s   " C : \ t o o l s " 
 
         e c h o   $ ( S Y S . P A T H )     / /   p r i n t s   t h e   v a l u e   o f   e n v .   v a r   P A T H   i . e .   " C : \ t o o l s " 
 
         e n v _ u n s e t   $ ( a )     / /   r e s t o r e   t h e   i n i t i a l   v a l u e   o f   P A T H 
 
     T h e   E N V _ U N S E T   c o m m a n d   r e m o v e s   o n l y   t h o s e   e n v i r o n m e n t   v a r i a b l e s   w h i c h 
 
     h a v e   b e e n   c r e a t e d   b y   t h e   E N V _ S E T   c o m m a n d   ( i . e .   d i d   n o t   e x i s t   b e f o r e ) . 
 
     O t h e r   e n v i r o n m e n t   v a r i a b l e s   ( s u c h   a s   P A T H ,   T E M P   e t c . )   a r e   n o t   r e m o v e d 
 
     b y   E N V _ U N S E T   b e c a u s e   t h e s e   v a r i a b l e s   w e r e   n o t   c r e a t e d   b y   E N V _ S E T . 
 
     I n s t e a d ,   E N V _ U N S E T   r e s t o r e s   i n i t i a l   v a l u e s   o f   t h e s e   v a r i a b l e s . 
 
     T h e   u s a g e   o f   " e n v _ s e t   l o c a l   < v a r >   =   . . . "   i s   s i m i l a r   t o   t h e   s e q u e n c e   o f 
 
     " e n v _ s e t   < v a r >   =   . . . " ,   d o i n g   s o m e t h i n g   w i t h   t h e   < v a r >   a n d   f i n a l l y   d o i n g 
 
     " e n v _ u n s e t   < v a r > " .   T h e r e   i s   a   d i f f e r e n c e ,   t h o u g h :   E N V _ U N S E T   r e s t o r e s   t h e 
 
     _ i n i t i a l _   v a l u e   o f   < v a r >   ( i . e .   b e f o r e   a n y   E N V _ S E T ) ,   w h i l e   " e n v _ s e t   l o c a l " 
 
     r e s t o r e s   t h e   _ p r e v i o u s _   v a l u e   o f   < v a r >   ( e . g .   a f t e r   t h e   l a s t   E N V _ S E T )   o n c e 
 
     t h e   c u r r e n t   N p p E x e c ' s   s c r i p t   e n d s . 
 
 S E E   A L S O : 
 
     s e t / u n s e t 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     i n p u t b o x 
 
 U S A G E : 
 
     i n p u t b o x   " m e s s a g e " 
 
     i n p u t b o x   " m e s s a g e "   :   i n i t i a l _ v a l u e 
 
     i n p u t b o x   " m e s s a g e "   : :   i n i t i a l _ v a l u e 
 
     i n p u t b o x   " m e s s a g e "   :   " v a l u e _ n a m e "   :   i n i t i a l _ v a l u e 
 
     i n p u t b o x   " m e s s a g e "   :   "   "   :   i n i t i a l _ v a l u e 
 
     i n p u t b o x   " m e s s a g e "   :   " v a l u e _ n a m e "   :   " i n i t i a l _ v a l u e "   :   t i m e _ m s 
 
     i n p u t b o x   " m e s s a g e "   : : :   t i m e o u t 
 
 D E S C R I P T I O N : 
 
     1 .   S h o w s   t h e   I n p u t B o x   w i t h   a   m e s s a g e   ' m e s s a g e ' ; 
 
           t h e   i n p u t   v a l u e   i s   s t o r e d   i n   $ ( I N P U T ) ,   $ ( I N P U T [ 1 ] )   e t c . 
 
     2 .   S h o w s   t h e   I n p u t B o x   w i t h   a   m e s s a g e   ' m e s s a g e ' ; 
 
           t h e   i n i t i a l   i n p u t   v a l u e   i s   s e t   t o   ' i n i t i a l _ v a l u e ' ; 
 
           t h e   i n p u t   v a l u e   i s   s t o r e d   i n   $ ( I N P U T ) ,   $ ( I N P U T [ 1 ] )   e t c . 
 
     3 .   S h o w s   t h e   I n p u t B o x   w i t h   a   m e s s a g e   ' m e s s a g e ' ; 
 
           t h e   t e x t   " $ ( I N P U T )   = "   i s   r e p l a c e d   w i t h   ' v a l u e _ n a m e ' 
 
           ( u s e   " "   t o   k e e p   " $ ( I N P U T )   = " ;   u s e   "   "   t o   e m p t y   i t ) ; 
 
           t h e   i n i t i a l   i n p u t   v a l u e   i s   s e t   t o   ' i n i t i a l _ v a l u e ' ; 
 
           t h e   i n p u t   v a l u e   i s   s t o r e d   i n   $ ( I N P U T ) ,   $ ( I N P U T [ 1 ] )   e t c . 
 
     4 .   S h o w s   t h e   I n p u t B o x   f o r   ' t i m e _ m s '   m i l l i s e c o n d s .   W h e n   t h e 
 
           ' t i m e _ m s '   i s   o v e r ,   t h e   I n p u t B o x   " e x p i r e s "   a n d   c l o s e s . 
 
     *   N o t e :   $ ( I N P U T ) ,   $ ( I N P U T [ 1 ] )   e t c .   a r e   l o c a l   v a r i a b l e s . 
 
 E X A M P L E S : 
 
     / /   s h o w   t h e   I n p u t B o x . . . 
 
     i n p u t b o x   " I n p u t   v a l u e s   o f   A ,   B   a n d   C   s e p a r a t e d   b y   s p a c e s : " 
 
     / /   u p d a t e   t h e   v a l u e s   o f   o u r   v a r i a b l e s . . . 
 
     s e t   l o c a l   a   =   $ ( i n p u t [ 1 ] )     / /   e . g .   ' A '   i n   ' A   " B   B "   C ' 
 
     s e t   l o c a l   b   =   $ ( i n p u t [ 2 ] )     / /   e . g .   ' B   B '   i n   ' A   " B   B "   C ' 
 
     s e t   l o c a l   c   =   $ ( i n p u t [ 3 ] )     / /   e . g .   ' C '   i n   ' A   " B   B "   C ' 
 
     / /   s h o w   t h e   I n p u t B o x   w i t h   s p e c i f i e d   i n i t i a l   v a l u e . . . 
 
     i n p u t b o x   " P l e a s e   c o n f i r m   t h e   v a l u e   o f   C : "   :   $ ( c ) 
 
     / /   u p d a t e   t h e   v a l u e   o f   c . . . 
 
     s e t   l o c a l   c   =   $ ( i n p u t ) 
 
     / /   s h o w   t h e   I n p u t B o x   w i t h   t h e   t e x t   " I n p u t   a : " ,   " a   = " . . . 
 
     i n p u t b o x   " I n p u t   a : "   :   " a   = "   : 
 
     / /   s h o w   t h e   I n p u t B o x   w i t h   e m p t y   v a l u e   n a m e . . . 
 
     i n p u t b o x   " I n p u t   a : "   :   "   "   :       / /   n o t i c e   t h e     :   "   "   :     p a r t ! 
 
     / /   s h o w   t h e   i n i t i a l   v a l u e   w i t h   a   c o l o n . . . 
 
     i n p u t b o x   " I n p u t   a : "   :   :   " 1   :   2 "       / /   n o t i c e   t h e     :   :     p a r t ! 
 
     / /   t h e   s a m e . . . 
 
     i n p u t b o x   " I n p u t   a : "   : :   " 1   :   2 "       / /   n o t i c e   t h e     : :     p a r t ! 
 
     / /   e x p i r a b l e   I n p u t B o x . . . 
 
     i n p u t b o x   " Y o u   h a v e   5   s e c o n d s   t o   i n p u t   a : "   :   a   :   1   :   5 0 0 0 
 
 R E M A R K S : 
 
     Y o u   c a n   u s e   a n y   e n v i r o n m e n t   v a r i a b l e   i n s i d e   t h e   i n p u t   v a l u e ,   e . g . 
 
         I N P U T B O X   " I n p u t   A : " 
 
         / /   . . .   t h e   I n p u t B o x   i s   s h o w n ,   y o u   c a n   t y p e   e . g . :   $ ( A R G V ) 
 
         S E T   l o c a l   a   =   $ ( I N P U T ) 
 
         / /   . . .   $ ( a )   b e c o m e s   $ ( I N P U T ) ,   i . e .   $ ( A R G V ) 
 
     T o   s e t   t h e   k e y b o a r d   f o c u s   t o   t h e   C o n s o l e   a f t e r   t h e   I n p u t B o x   i s   s h o w n , 
 
     u s e   t h e   f o l l o w i n g   c o m m a n d : 
 
         n p p _ s e t f o c u s   c o n 
 
 S E E   A L S O : 
 
     s e t ,   u n s e t ,   i f ,   m e s s a g e b o x 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     m e s s a g e b o x 
 
 U S A G E : 
 
     m e s s a g e b o x   " t e x t " 
 
     m e s s a g e b o x   " t e x t "   :   " t i t l e " 
 
     m e s s a g e b o x   " t e x t "   :   " t i t l e "   :   t y p e 
 
     m e s s a g e b o x   " t e x t "   :   :   t y p e 
 
     m e s s a g e b o x   " t e x t "   :   " t i t l e "   :   t y p e   :   t i m e _ m s 
 
     m e s s a g e b o x   " t e x t "   : : :   t i m e _ m s 
 
 D E S C R I P T I O N : 
 
     1 .   S h o w s   a   M e s s a g e B o x   w i t h   a   t e x t   ' t e x t '   a n d   d e f a u l t   t i t l e ; 
 
     2 .   S h o w s   a   M e s s a g e B o x   w i t h   a   t e x t   ' t e x t '   a n d   a   t i t l e   ' t i t l e ' ; 
 
     3 .   S h o w s   a   M e s s a g e B o x   o f   t h e   g i v e n   t y p e   w i t h   a   t e x t   ' t e x t '   a n d   a   t i t l e   ' t i t l e ' ; 
 
     4 .   S h o w s   a   M e s s a g e B o x   o f   t h e   g i v e n   t y p e   w i t h   a   t e x t   ' t e x t '   a n d   d e f a u l t   t i t l e ; 
 
     5 .   S h o w s   a   M e s s a g e B o x   f o r   ' t i m e _ m s '   m i l l i s e c o n d s   a n d   t h e n   c l o s e s   i t ; 
 
     T h e   t y p e   c a n   b e : 
 
         0   o r   " m s g "     -   a   m e s s a g e 
 
         1   o r   " w a r n "   -   a   w a r n i n g 
 
         2   o r   " e r r "     -   a n   e r r o r 
 
 E X A M P L E S : 
 
     m e s s a g e b o x   " T h i s   i s   a   s i m p l e   m e s s a g e " 
 
     m e s s a g e b o x   " T h i s   i s   a   s i m p l e   m e s s a g e "   : :   0   / /   t h e   s a m e 
 
     m e s s a g e b o x   " T h i s   i s   a   s i m p l e   m e s s a g e "   :   :   m s g   / /   t h e   s a m e 
 
     m e s s a g e b o x   " T h i s   i s   a n   e r r o r ! "   : :   e r r 
 
     m e s s a g e b o x   " T h i s   i s   a   c u s t o m   e r r o r ! "   :   " E R R O R "   :   2 
 
     m e s s a g e b o x   " T h i s   i s   a   c u s t o m   w a r n i n g ! "   :   " W A R N I N G "   :   w a r n 
 
     m e s s a g e b o x   " Y o u   w i l l   s e e   i t   d u r i n g   3   s e c o n d s ! "   : : :   3 0 0 0 
 
 R E M A R K S : 
 
     T o   s e t   t h e   k e y b o a r d   f o c u s   t o   t h e   C o n s o l e   a f t e r   t h e   M e s s a g e B o x   i s   s h o w n , 
 
     u s e   t h e   f o l l o w i n g   c o m m a n d : 
 
         n p p _ s e t f o c u s   c o n 
 
 S E E   A L S O : 
 
     i n p u t b o x 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     n p e _ c m d a l i a s 
 
 U S A G E : 
 
     n p e _ c m d a l i a s 
 
     n p e _ c m d a l i a s   < a l i a s > 
 
     n p e _ c m d a l i a s   < a l i a s >   = 
 
     n p e _ c m d a l i a s   < a l i a s >   =   < c o m m a n d > 
 
     n p e _ c m d a l i a s   + v   < a l i a s >   =   < c o m m a n d > 
 
     n p e _ c m d a l i a s   - v   < a l i a s >   =   < c o m m a n d > 
 
 D E S C R I P T I O N : 
 
     1 .   S h o w s   a l l   c o m m a n d   a l i a s e s   ( " n p e _ c m d a l i a s "   w i t h o u t   p a r a m e t e r s ) 
 
     2 .   S h o w s   t h e   v a l u e   o f   c o m m a n d   a l i a s   ( " n p e _ c m d a l i a s "   w i t h o u t   " = " ) 
 
     3 .   R e m o v e s   t h e   c o m m a n d   a l i a s   ( " n p e _ c m d a l i a s "   w i t h   e m p t y   " = " ) 
 
     4 .   S e t s   t h e   v a l u e   o f   c o m m a n d   a l i a s   ( " n p e _ c m d a l i a s   < a l i a s >   =   < c o m m a n d > " ) 
 
     5 . 1 .   + v   u s e s   d e l a y e d   v a r s   s u b s t i t u t i o n   ( d e f a u l t ) ,   e . g .   $ ( x )   r e m a i n s   $ ( x ) 
 
     5 . 2 .   - v   u s e s   i n s t a n t   v a r s   s u b s t i t u t i o n ,   e . g .   $ ( x )   i s   r e p l a c e d   w i t h   i t s   v a l u e 
 
 E X A M P L E S : 
 
     / /   b a s i c   e x a m p l e s : 
 
     n p e _ c m d a l i a s   =   =   c a l c                         / /   t y p e   j u s t   " = "   i n s t e a d   o f   " c a l c " 
 
     n p e _ c m d a l i a s   c o p y   =   c m d   / c   c o p y     / /   " c o p y "   i n s t e a d   o f   " c m d   / c   c o p y " 
 
     n p e _ c m d a l i a s   / c   =   c m d   / c                   / /   " / c "   i n s t e a d   o f   " c m d   / c " 
 
     n p e _ c m d a l i a s   / c                                     / /   s h o w   t h e   v a l u e   o f   c o m m a n d   a l i a s 
 
     n p e _ c m d a l i a s   / c   =                                 / /   r e m o v e   t h e   c o m m a n d   a l i a s 
 
     / /   e x a m p l e s   w i t h   + v   a n d   - v : 
 
     n p e _ c m d a l i a s   e 1   =   e c h o   $ ( A ) ,   $ ( B )   / /   u s e s   d e l a y e d   s u b s t i t u t i o n 
 
     n p e _ c m d a l i a s   + v   e 2   =   e c h o   $ ( A ) ,   $ ( B )   / /   u s e s   d e l a y e d   s u b s t i t u t i o n 
 
     s e t   A   =   1 2 3 
 
     s e t   B   =   4 5 6 
 
     e 1   / /   p r i n t s   " 1 2 3 ,   4 5 6 "   b e c a u s e   d e l a y e d   s u b s t i t u t i o n   i s   u s e d 
 
     e 2   / /   p r i n t s   " 1 2 3 ,   4 5 6 "   b e c a u s e   d e l a y e d   s u b s t i t u t i o n   i s   u s e d 
 
     n p e _ c m d a l i a s   - v   e 3   =   e c h o   $ ( A ) ,   $ ( B )   / /   u s e s   i n s t a n t   s u b s t i t u t i o n 
 
     s e t   A   =   a b c 
 
     s e t   B   =   d e f 
 
     e 1   / /   p r i n t s   " a b c ,   d e f "   b e c a u s e   d e l a y e d   s u b s t i t u t i o n   i s   u s e d 
 
     e 2   / /   p r i n t s   " a b c ,   d e f "   b e c a u s e   d e l a y e d   s u b s t i t u t i o n   i s   u s e d 
 
     e 3   / /   p r i n t s   " 1 2 3 ,   4 5 6 "   b e c a u s e   i n s t a n t   s u b s t i t u t i o n   w a s   u s e d 
 
     / /   d e l a y e d   s u b s t i t u t i o n   e x a m p l e : 
 
     n p e _ c m d a l i a s   f p   =   n i r c m d   c l i p b o a r d   s e t   $ ( F U L L _ C U R R E N T _ P A T H ) 
 
     f p   / /   a l w a y s   u s e s   t h e   a c t u a l   f i l e   p a t h 
 
     / /   n o w   o p e n   o r   s w i t c h   t o   a n o t h e r   f i l e   i n   N o t e p a d + + 
 
     f p   / /   a l w a y s   u s e s   t h e   a c t u a l   f i l e   p a t h 
 
 R E M A R K S : 
 
     T o   u s e   a   c o m m a n d   a l i a s ,   t y p e   i t   i n   t h e   b e g i n n i n g   o f   t h e   i n p u t   s t r i n g 
 
     ( e . g .   " / c   c o p y   / ? "   f o r   t h e   c o m m a n d   a l i a s   " / c   - >   c m d   / c " ) ,   o t h e r w i s e 
 
     i t   w i l l   N O T   b e   t r e a t e d   a s   a   c o m m a n d   a l i a s .   F o r   e x a m p l e ,   " / c "   i n s i d e 
 
     " c m d   / c   m o v e   / ? "   i s   n o t   t r e a t e d   a s   a   c o m m a n d   a l i a s   b e c a u s e   i t   i s   l o c a t e d 
 
     i n   t h e   m i d d l e   o f   t h e   s t r i n g ,   s o   t h i s   s t r i n g   r e m a i n s   u n m o d i f i e d . 
 
     T o   u s e   - v   o r   + v   a s   t h e   a l i a s   n a m e ,   j u s t   s p e c i f y   t h e   d e s i r e d   m o d e   p r i o r 
 
     t o   t h e   a l i a s   n a m e : 
 
         n p e _ c m d a l i a s   - v   - v   =   . . .   / /   a l i a s   n a m e   i s   " - v " ,   i n s t a n t   s u b s t i t u t i o n 
 
         n p e _ c m d a l i a s   + v   - v   =   . . .   / /   a l i a s   n a m e   i s   " - v " ,   d e l a y e d   s u b s t i t u t i o n 
 
 S E E   A L S O : 
 
     n p e _ c o n s o l e   q + / q - 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     n p e _ c o n s o l e 
 
 U S A G E : 
 
     n p e _ c o n s o l e 
 
     n p e _ c o n s o l e   a + / a -   d + / d -   e 0 / e 1   h + / h -   m + / m -   p + / p -   q + / q -   v + / v -   j + / j -   f + / f -   r + / r -   x + / x -   k 0 . . 3 
 
     n p e _ c o n s o l e   c < N >   s < N > 
 
     n p e _ c o n s o l e   o 0 / o 1 / o 2   i 0 / i 1 / i 2 
 
     n p e _ c o n s o l e   < o p t i o n s >   - - 
 
     n p e _ c o n s o l e   l o c a l   < o p t i o n s > 
 
 D E S C R I P T I O N : 
 
     1 .   W i t h o u t   p a r a m e t e r   -   s h o w s   c u r r e n t   C o n s o l e   o p t i o n s / m o d e 
 
     2 .   X + / X -     e n a b l e s / d i s a b l e s   t h e   o p t i o n / m o d e   X : 
 
               a + / a -     a p p e n d   m o d e   ( d o n ' t   c l e a r   C o n s o l e )   o n / o f f 
 
               d + / d -     f o l l o w   $ ( C U R R E N T _ D I R E C T O R Y )   o n / o f f 
 
               e 0 / e 1     a n s i   e s c a p e   s e q u e n c e s :   r a w / r e m o v e 
 
               h + / h -     c o n s o l e   c o m m a n d s   h i s t o r y   o n / o f f 
 
               m + / m -     c o n s o l e   i n t e r n a l   m e s s a g e s   o n / o f f 
 
               p + / p -     p r i n t   " = = = =   R E A D Y   = = = = "   o n / o f f 
 
               q + / q -     c o m m a n d   a l i a s e s   o n / o f f 
 
               v + / v -     s e t   t h e   $ ( O U T P U T )   l o c a l   v a r i a b l e   o n / o f f 
 
               j + / j -     k i l l   p r o c e s s   t r e e   o n / o f f 
 
               f + / f -     c o n s o l e   o u t p u t   f i l t e r   o n / o f f 
 
               r + / r -     c o n s o l e   o u t p u t   r e p l a c e   f i l t e r   o n / o f f 
 
               x + / x -     c o m p i l e r   e r r o r s   h i g h l i g h t   f i l t e r   o n / o f f 
 
               k 0 . . 3     c a t c h   N p p E x e c ' s   s h o r t c u t   k e y s   o n / o f f 
 
               c < N >       t e x t   p r o c e s s i n g   f o r   E x e c u t e   C l i p b o a r d   T e x t 
 
               s < N >       t e x t   p r o c e s s i n g   f o r   E x e c u t e   S e l e c t e d   T e x t 
 
     3 .   Y 0 / Y 1 / Y 2     s e t s   t h e   v a l u e   o f   t h e   o p t i o n / m o d e   Y : 
 
               o 0 / o 1 / o 2     c o n s o l e   o u t p u t   e n c o d i n g :   A N S I / O E M / U T F 8 
 
               i 0 / i 1 / i 2     c o n s o l e   i n p u t   e n c o d i n g :   A N S I / O E M / U T F 8 
 
     4 .   - -     s i l e n t   ( d o n ' t   p r i n t   C o n s o l e   m o d e   i n f o ) 
 
     5 .   l o c a l   w i t h i n   t h e   c u r r e n t   N p p E x e c ' s   s c r i p t 
 
     W h e n   " l o c a l "   i s   s p e c i f i e d ,   t h e   c h a n g e s   a r e   a p p l i e d   l o c a l l y   t o   t h e   c u r r e n t 
 
     N p p E x e c ' s   s c r i p t   a n d   a r e   r e v e r t e d   b a c k   w h e n   t h e   c u r r e n t   s c r i p t   e n d s . 
 
 E X A M P L E S : 
 
     n p e _ c o n s o l e   o 1   i 1   a +   - - 
 
         / / / /   O E M / O E M ,   a p p e n d   m o d e ,   s i l e n t 
 
     n p e _ c o n s o l e   h +   m +   a -   i 0   o 0 
 
         / / / /   h i s t o r y   o n ,   i n t .   m s g s   o n ,   d o n ' t   a p p e n d ,   A N S I / A N S I 
 
     n p e _ c o n s o l e   d +   k 0   q - 
 
         / / / /   f o l l o w   c u r r .   d i r ,   d o n ' t   c a t c h   s h o r t c u t   k e y s ,   c m d   a l i a s e s   o f f 
 
     n p e _ c o n s o l e   - -   v +   m -   / /   s i l e n t ,   e n a b l e   t h e   $ ( O U T P U T )   v a r ,   n o   i n t . m s g s 
 
     c m d   / c   t i m e   / t               / /   c m d   p r i n t s   c u r r e n t   t i m e ;   $ ( O U T P U T )   i s   s e t 
 
     e c h o   $ ( O U T P U T )               / /   N p p E x e c   p r i n t s   $ ( O U T P U T )   i . e .   c u r r e n t   t i m e 
 
     n p e _ c o n s o l e   - -   v -   m +   / /   d o n ' t   f o r g e t   t o   d i s a b l e   t h e   $ ( O U T P U T )   v a r 
 
     n p e _ c o n s o l e   l o c a l   - -   v +   m -   / /   h a s   l o c a l   e f f e c t 
 
 R E M A R K S : 
 
     a + / a -     C o n s o l e   a p p e n d   m o d e   o n / o f f . 
 
                   T h e r e   i s   n o   c o r r e s p o n d i n g   m e n u   i t e m . 
 
                   T h i s   o p t i o n   i s   n o t   s a v e d   w h e n   y o u   c l o s e   N o t e p a d + + . 
 
                   D e f a u l t   v a l u e :   o f f 
 
                   ( C o n s o l e   i s   a u t o m a t i c a l l y   c l e a r e d   w h e n   n e w   s c r i p t   s t a r t s ) . 
 
     d + / d -     F o l l o w   $ ( C U R R E N T _ D I R E C T O R Y )   o n / o f f . 
 
                   C o r r e s p o n d i n g   m e n u   i t e m :   F o l l o w   $ ( C U R R E N T _ D I R E C T O R Y ) . 
 
                   I f   O n ,   N p p E x e c   f o l l o w s   t h e   d i r e c t o r y   o f   c u r r e n t   f i l e . 
 
     e 0 / e 1     A N S I   e s c a p e   s e q u e n c e s :   r a w / r e m o v e . 
 
                   e 0 :   k e e p   r a w   e s c - s e q u e n c e   c h a r a c t e r s ; 
 
                   e 1 :   r e m o v e   e s c - s e q u e n c e   c h a r a c t e r s . 
 
                   T h e r e   i s   n o   c o r r e s p o n d i n g   m e n u   i t e m . 
 
                   T h i s   o p t i o n   i s   s a v e d   a s   " A n s i E s c a p e S e q u e n c e s " . 
 
                   D e f a u l t   v a l u e :   0 . 
 
     h + / h -     C o n s o l e   c o m m a n d s   h i s t o r y   o n / o f f . 
 
                   C o r r e s p o n d i n g   m e n u   i t e m :   C o n s o l e   C o m m a n d s   H i s t o r y . 
 
                   I f   O n ,   N p p E x e c ' s   C o n s o l e   r e m e m b e r s   t h e   c o m m a n d s   y o u   t y p e d . 
 
     m + / m -     C o n s o l e   i n t e r n a l   m e s s a g e s   o n / o f f . 
 
                   C o r r e s p o n d i n g   m e n u   i t e m   ( i n v e r s e ) :   N o   i n t e r n a l   m e s s a g e s . 
 
                   I f   O n ,   N p p E x e c ' s   C o n s o l e   p r i n t s   a l l   i n t e r n a l   ( g r e e n )   m e s s a g e s . 
 
     p + / p -     P r i n t   " = = = =   R E A D Y   = = = = "   o n / o f f . 
 
                   T h e r e   i s   n o   c o r r e s p o n d i n g   m e n u   i t e m . 
 
                   T h i s   o p t i o n   i s   s a v e d   a s   " P r i n t M s g R e a d y " . 
 
                   D e f a u l t   v a l u e :   o n . 
 
     q + / q -     C o m m a n d   a l i a s e s   o n / o f f . 
 
                   T h e r e   i s   n o   c o r r e s p o n d i n g   m e n u   i t e m . 
 
                   T h i s   o p t i o n   i s   n o t   s a v e d   w h e n   y o u   c l o s e   N o t e p a d + + . 
 
                   D e f a u l t   v a l u e :   o n 
 
                   ( c o m m a n d   a l i a s e s   c r e a t e d   w i t h   N P E _ C M D A L I A S   a r e   a c t i v e ) . 
 
     v + / v -     S e t   t h e   $ ( O U T P U T )   l o c a l   v a r i a b l e   o n / o f f . 
 
                   ( t h i s   v a r i a b l e   w i l l   s t o r e   t h e   c h i l d   p r o c e s s ' e s   o u t p u t ) . 
 
                   T h e r e   i s   n o   c o r r e s p o n d i n g   m e n u   i t e m . 
 
                   T h i s   o p t i o n   i s   n o t   s a v e d   w h e n   y o u   c l o s e   N o t e p a d + + . 
 
                   D e f a u l t   v a l u e :   o f f . 
 
     j + / j -     K i l l   p r o c e s s   t r e e   o n / o f f . 
 
                   W h e n   t h i s   o p t i o n   i s   O n ,   k i l l i n g   a   r u n n i n g   c h i l d   p r o c e s s   ( t h e   o n e 
 
                   t h a t   r u n s   i n   N p p E x e c ' s   C o n s o l e )   a l s o   k i l l s   a n y   p r o c e s s e s   t h a t   w e r e 
 
                   s t a r t e d   f r o m   t h i s   r u n n i n g   c h i l d   p r o c e s s . 
 
                   T h e r e   i s   n o   c o r r e s p o n d i n g   m e n u   i t e m . 
 
                   T h i s   o p t i o n   i s   s a v e d   a s   " K i l l P r o c T r e e " . 
 
                   D e f a u l t   v a l u e :   o f f . 
 
     f + / f -     C o n s o l e   o u t p u t   f i l t e r   o n / o f f . 
 
                   C o r r e s p o n d i n g   m e n u   i t e m :   C o n s o l e   O u t p u t   F i l t e r s . . . 
 
     r + / r -     C o n s o l e   o u t p u t   r e p l a c e   f i l t e r   o n / o f f . 
 
                   C o r r e s p o n d i n g   m e n u   i t e m :   C o n s o l e   O u t p u t   F i l t e r s . . . 
 
     x + / x -     C o m p i l e r   e r r o r s   h i g h l i g h t   f i l t e r   o n / o f f 
 
                   E n a b l e s   o r   d i s a b l e s   a   b u i l t - i n   h i g h l i g h t   f i l t e r   t h a t   c a t c h e s   a n d 
 
                   h i g h l i g h t s   m o s t   o f   c o m p i l e r s '   e r r o r s .   T h i s   f i l t e r   h a s   l o w e r   p r i o r i t y 
 
                   t h a n   t h e   u s e r - d e f i n e d   h i g h l i g h t   m a s k s . 
 
                   T h e r e   i s   n o   c o r r e s p o n d i n g   m e n u   i t e m . 
 
                   T h i s   o p t i o n   i s   s a v e d   a s   " C o m p i l e r E r r o r s " . 
 
                   D e f a u l t   v a l u e :   o f f . 
 
     k 0 . . 3     C a t c h   N p p E x e c ' s   s h o r t c u t   k e y s   o n / o f f 
 
                   C o n t r o l s   i f   N p p E x e c ' s   C o n s o l e   c a t c h e s   s h o r t c u t   k e y s   r e l a t e d 
 
                   t o   N p p E x e c ' s   m e n u   i t e m s   o r   s c r i p t s .   T h i s   a l l o w s   t o   e x e c u t e 
 
                   t h e   c o r r e s p o n d i n g   c o m m a n d s   f r o m   N p p E x e c ' s   C o n s o l e   w h e n   t h e 
 
                   a s s o c i a t e d   s h o r t c u t   k e y s   a r e   p r e s s e d . 
 
                   k 0 :   D o   n o t   c a t c h   N p p E x e c ' s   s h o r t c u t   k e y s ; 
 
                   k 1 :   C a t c h   s t a n d a r d   N p p E x e c ' s   s h o r t c u t   k e y s   ( E x e c u t e . . .   e t c . ) ; 
 
                   k 2 :   C a t c h   u s e r ' s   N p p E x e c ' s   s h o r t c u t   k e y s   ( s c r i p t s '   m e n u   i t e m s ) ; 
 
                   k 3 :   C a t c h   a l l   N p p E x e c ' s   s h o r t c u t   k e y s   ( s t a n d a r d + s c r i p t s ) . 
 
                   T h e r e   i s   n o   c o r r e s p o n d i n g   m e n u   i t e m . 
 
                   T h i s   o p t i o n   i s   n o t   s a v e d   w h e n   y o u   c l o s e   N o t e p a d + + . 
 
                   D e f a u l t   v a l u e :   3 . 
 
     c < N >       T e x t   p r o c e s s i n g   f o r   E x e c u t e   C l i p b o a r d   T e x t . 
 
                   T h e   v a l u e   o f   < N >   c a n   b e   e i t h e r   0   o r   a   s u m   o f   t h e s e   f l a g s : 
 
                   0 :     u s e   t h e   c l i p b o a r d   t e x t   a s   i s ; 
 
                           i f   t h e r e   i s   a   r u n n i n g   c h i l d   p r o c e s s   t h e n   s e n d   t h e   c l i p b o a r d 
 
                           t e x t   t o   t h a t   p r o c e s s   a s   a n   i n p u t ; 
 
                   1 :     ( v s )   s u b s t i t u t e   m a c r o - v a r s   i n   t h e   c l i p b o a r d   t e x t   b e f o r e   t h e   e x e c u t i o n 
 
                           i f   t h e r e   i s   n o   r u n n i n g   c h i l d   p r o c e s s ; 
 
                   2 :     ( v p )   s u b s t i t u t e   m a c r o - v a r s   i n   t h e   c l i p b o a r d   t e x t   b e f o r e   t h e   e x e c u t i o n 
 
                           i f   t h e r e   i s   a   r u n n i n g   c h i l d   p r o c e s s ; 
 
                   4 :     ( c s )   i f   t h e   f i r s t   l i n e   o f   t h e   c l i p b o a r d   t e x t   i s   " ! c o l l a t e r a l "   a n d 
 
                           t h e r e   i s   n o   r u n n i n g   c h i l d   p r o c e s s   t h e n   s t a r t   a   c o l l a t e r a l   s c r i p t ; 
 
                   8 :     ( c p )   i f   t h e   f i r s t   l i n e   o f   t h e   c l i p b o a r d   t e x t   i s   " ! c o l l a t e r a l "   a n d 
 
                           t h e r e   i s   a   r u n n i n g   c h i l d   p r o c e s s   t h e n   s t a r t   a   c o l l a t e r a l   s c r i p t ; 
 
                   1 6 :   ( n e )   l i n e s   t h a t   s t a r t   w i t h   t h e   " n p p e x e c : "   p r e f i x   w i l l   b e   e x e c u t e d   b y 
 
                           N p p E x e c   ( a s   N p p E x e c ' s   s c r i p t   c o m m a n d s )   a n d   w i l l   n o t   b e   s e n t   t o 
 
                           a   r u n n i n g   c h i l d   p r o c e s s ; 
 
                   3 2 :   ( l s )   u p d a t e   t h e   l a s t   e x e c u t e d   s c r i p t :   E x e c u t e   C l i p b o a r d   T e x t   u p d a t e s 
 
                           t h e   c o m m a n d s   t h a t   w i l l   b e   e x e c u t e d   b y   E x e c u t e   P r e v i o u s   N p p E x e c   S c r i p t ; 
 
                   6 4 :   ( s v )   s h a r e   l o c a l   v a r i a b l e s :   E x e c u t e   C l i p b o a r d   T e x t   u s e s   a n d   u p d a t e s 
 
                           t h e   e x i s t i n g   l o c a l   v a r i a b l e s   i n s t e a d   o f   i t s   o w n   l o c a l   v a r i a b l e s . 
 
                   T h e r e   i s   n o   c o r r e s p o n d i n g   m e n u   i t e m . 
 
                   T h i s   o p t i o n   i s   s a v e d   a s   " E x e c C l i p T e x t M o d e " . 
 
                   D e f a u l t   v a l u e :   6 0   ( 4 + 8 + 1 6 + 3 2 ) . 
 
     s < N >       T e x t   p r o c e s s i n g   f o r   E x e c u t e   S e l e c t e d   T e x t . 
 
                   T h e   v a l u e   o f   < N >   c a n   b e   e i t h e r   0   o r   a   s u m   o f   t h e s e   f l a g s : 
 
                   0 :     u s e   t h e   s e l e c t e d   t e x t   a s   i s ; 
 
                           i f   t h e r e   i s   a   r u n n i n g   c h i l d   p r o c e s s   t h e n   s e n d   t h e   s e l e c t e d 
 
                           t e x t   t o   t h a t   p r o c e s s   a s   a n   i n p u t ; 
 
                   1 :     ( v s )   s u b s t i t u t e   m a c r o - v a r s   i n   t h e   s e l e c t e d   t e x t   b e f o r e   t h e   e x e c u t i o n 
 
                           i f   t h e r e   i s   n o   r u n n i n g   c h i l d   p r o c e s s ; 
 
                   2 :     ( v p )   s u b s t i t u t e   m a c r o - v a r s   i n   t h e   s e l e c t e d   t e x t   b e f o r e   t h e   e x e c u t i o n 
 
                           i f   t h e r e   i s   a   r u n n i n g   c h i l d   p r o c e s s ; 
 
                   4 :     ( c s )   i f   t h e   f i r s t   l i n e   o f   t h e   s e l e c t e d   t e x t   i s   " ! c o l l a t e r a l "   a n d 
 
                           t h e r e   i s   n o   r u n n i n g   c h i l d   p r o c e s s   t h e n   s t a r t   a   c o l l a t e r a l   s c r i p t ; 
 
                   8 :     ( c p )   i f   t h e   f i r s t   l i n e   o f   t h e   s e l e c t e d   t e x t   i s   " ! c o l l a t e r a l "   a n d 
 
                           t h e r e   i s   a   r u n n i n g   c h i l d   p r o c e s s   t h e n   s t a r t   a   c o l l a t e r a l   s c r i p t ; 
 
                   1 6 :   ( n e )   l i n e s   t h a t   s t a r t   w i t h   t h e   " n p p e x e c : "   p r e f i x   w i l l   b e   e x e c u t e d   b y 
 
                           N p p E x e c   ( a s   N p p E x e c ' s   s c r i p t   c o m m a n d s )   a n d   w i l l   n o t   b e   s e n t   t o 
 
                           a   r u n n i n g   c h i l d   p r o c e s s ; 
 
                   3 2 :   ( l s )   u p d a t e   t h e   l a s t   e x e c u t e d   s c r i p t :   E x e c u t e   S e l e c t e d   T e x t   u p d a t e s   t h e 
 
                           c o m m a n d s   t h a t   w i l l   b e   e x e c u t e d   b y   E x e c u t e   P r e v i o u s   N p p E x e c   S c r i p t ; 
 
                   6 4 :   ( s v )   s h a r e   l o c a l   v a r i a b l e s :   E x e c u t e   S e l e c t e d   T e x t   u s e s   a n d   u p d a t e s 
 
                           t h e   e x i s t i n g   l o c a l   v a r i a b l e s   i n s t e a d   o f   i t s   o w n   l o c a l   v a r i a b l e s . 
 
                   T h e r e   i s   n o   c o r r e s p o n d i n g   m e n u   i t e m . 
 
                   T h i s   o p t i o n   i s   s a v e d   a s   " E x e c S e l T e x t M o d e " . 
 
                   D e f a u l t   v a l u e :   6 0   ( 4 + 8 + 1 6 + 3 2 ) . 
 
     o 0 / o 1 / o 2     C o n s o l e   o u t p u t   e n c o d i n g :   A N S I / O E M / U T F 8 
 
                         C o r r e s p o n d i n g   m e n u   i t e m :   C o n s o l e   O u t p u t . . . 
 
                         S e t s   C o n s o l e   o u t p u t   e n c o d i n g . 
 
     i 0 / i 1 / i 2     C o n s o l e   i n p u t   e n c o d i n g :   A N S I / O E M / U T F 8 
 
                         C o r r e s p o n d i n g   m e n u   i t e m :   C o n s o l e   O u t p u t . . . 
 
                         S e t s   C o n s o l e   i n p u t   e n c o d i n g . 
 
 S E E   A L S O : 
 
     c o n _ f i l t e r ,   n p p _ c o n s o l e ,   n p e _ n o e m p t y v a r s 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     n p e _ d e b u g l o g 
 
 U S A G E : 
 
     n p e _ d e b u g l o g 
 
     n p e _ d e b u g l o g   o n 
 
     n p e _ d e b u g l o g   1 
 
     n p e _ d e b u g l o g   o f f 
 
     n p e _ d e b u g l o g   0 
 
     n p e _ d e b u g l o g   l o c a l   1 / 0 
 
 D E S C R I P T I O N : 
 
     1 .   W i t h o u t   p a r a m e t e r   -   s h o w s   c u r r e n t   D e b u g   L o g   s t a t e   ( O n / O f f ) 
 
     2 .   O n   o r   1   -   e n a b l e s   t h e   D e b u g   L o g   i n   N p p E x e c ' s   C o n s o l e 
 
     3 .   O f f   o r   0   -   d i s a b l e s   t h e   D e b u g   L o g   i n   N p p E x e c ' s   C o n s o l e 
 
     4 .   l o c a l   -   e n a b l e s / d i s a b l e s   t h e   D e b u g   L o g   l o c a l l y 
 
     W h e n   " l o c a l "   i s   s p e c i f i e d ,   t h e   c h a n g e s   a r e   a p p l i e d   l o c a l l y   t o   t h e   c u r r e n t 
 
     N p p E x e c ' s   s c r i p t   a n d   a r e   r e v e r t e d   b a c k   w h e n   t h e   c u r r e n t   s c r i p t   e n d s . 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     n p e _ n o e m p t y v a r s 
 
 U S A G E : 
 
     n p e _ n o e m p t y v a r s 
 
     n p e _ n o e m p t y v a r s   1 
 
     n p e _ n o e m p t y v a r s   0 
 
     n p e _ n o e m p t y v a r s   l o c a l   1 / 0 
 
 D E S C R I P T I O N : 
 
     1 .   W i t h o u t   p a r a m e t e r   -   s h o w s   c u r r e n t   o p t i o n ' s   s t a t e 
 
     2 .   1   o r   O n   -   e n a b l e s   r e p l a c e m e n t   o f   e m p t y   ( u n i n i t i a l i z e d )   v a r s 
 
     3 .   0   o r   O f f   -   d i s a b l e s   r e p l a c e m e n t   o f   e m p t y   ( u n i n i t i a l i z e d )   v a r s 
 
     4 .   l o c a l   -   e n a b l e s / d i s a b l e s   e m p t y   v a r s   l o c a l l y 
 
     W h e n   " l o c a l "   i s   s p e c i f i e d ,   t h e   c h a n g e s   a r e   a p p l i e d   l o c a l l y   t o   t h e   c u r r e n t 
 
     N p p E x e c ' s   s c r i p t   a n d   a r e   r e v e r t e d   b a c k   w h e n   t h e   c u r r e n t   s c r i p t   e n d s . 
 
 E X A M P L E S : 
 
     u n s e t   v a r                         / /   t o   b e   s u r e   t h a t   $ ( v a r )   i s   u n i n i t i a l i z e d 
 
     u n s e t   l o c a l   v a r             / /   t o   b e   s u r e   t h a t   $ ( v a r )   i s   u n i n i t i a l i z e d 
 
     n p e _ n o e m p t y v a r s   0         / /   d i s a b l e d 
 
     e c h o   v a r   =   " $ ( v a r ) "     / /   p r i n t s :   v a r   =   " $ ( v a r ) " 
 
     n p e _ n o e m p t y v a r s   1         / /   e n a b l e d 
 
     e c h o   v a r   =   " $ ( v a r ) "     / /   p r i n t s :   v a r   =   " " 
 
     n p e _ n o e m p t y v a r s   l o c a l   1         / /   e n a b l e d   l o c a l l y 
 
 R E M A R K S : 
 
     R e f e r   t o   N p p E x e c . i n i ,   p a r a m e t e r   N o E m p t y V a r s   i n   t h e   [ C o n s o l e ]   s e c t i o n . 
 
     T h i s   o p t i o n   i s   n o t   s a v e d   w h e n   y o u   c l o s e   N o t e p a d + + . 
 
 S E E   A L S O : 
 
     s e t ,   e c h o ,   n p e _ c o n s o l e 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     n p e _ q u e u e 
 
 U S A G E : 
 
     n p e _ q u e u e   < c o m m a n d > 
 
     n p e _ q u e u e   + s / - s   + v / - v   < c o m m a n d > 
 
 D E S C R I P T I O N : 
 
     Q u e u e s   a   c o m m a n d   t o   b e   e x e c u t e d   a f t e r   t h e   c u r r e n t   N p p E x e c ' s   s c r i p t   i s   f i n i s h e d . 
 
     + s   -   e x e c u t e   t h e   q u e u e d   c o m m a n d   a s   a   s e p a r a t e   N p p E x e c ' s   s c r i p t   ( d e f a u l t ) 
 
     - s   -   e x e c u t e   t h e   q u e u e d   c o m m a n d   i n   t h e   s c o p e   o f   t h e   c u r r e n t   N p p E x e c ' s   s c r i p t 
 
     + v   -   u s e   d e l a y e d   v a r s   s u b s t i t u t i o n   ( d e f a u l t ) ,   e . g .   $ ( x )   r e m a i n s   $ ( x ) 
 
     - v   -   u s e   i n s t a n t   v a r s   s u b s t i t u t i o n ,   e . g .   $ ( x )   i s   r e p l a c e d   w i t h   i t s   v a l u e 
 
 E X A M P L E S : 
 
     / /   q u e u e   e a c h   c o m m a n d   a s   a   s e p a r a t e   s c r i p t : 
 
     s e t   X   =   1 0 
 
     n p e _ q u e u e   s e t   X   =   2 0   / /   q u e u e d :   w i l l   s e t   X   t o   2 0 
 
     e c h o   $ ( X )   / /   p r i n t s   t h e   c u r r e n t   v a l u e   o f   X ,   i . e .   1 0 
 
     n p e _ q u e u e   e c h o   $ ( X )   / /   q u e u e d :   w i l l   p r i n t   t h e   l a t e s t   v a l u e   o f   X ,   i . e .   2 0 
 
     n p e _ q u e u e   - v   e c h o   $ ( X )   / /   q u e u e d :   w i l l   p r i n t   t h e   c u r r e n t   v a l u e   o f   X ,   i . e .   1 0 
 
     / /   q u e u e   i n   t h e   s c o p e   o f   t h e   c u r r e n t   s c r i p t : 
 
     s e t   X   =   1 0 
 
     n p e _ q u e u e   - s   s e t   X   =   2 0   / /   q u e u e d :   w i l l   s e t   X   t o   2 0 
 
     e c h o   $ ( X )   / /   p r i n t s   t h e   c u r r e n t   v a l u e   o f   X ,   i . e .   1 0 
 
     n p e _ q u e u e   - s   + v   e c h o   $ ( X )   / /   q u e u e d :   w i l l   p r i n t   t h e   l a t e s t   v a l u e   o f   X ,   i . e .   2 0 
 
     n p e _ q u e u e   - v   - s   e c h o   $ ( X )   / /   q u e u e d :   w i l l   p r i n t   t h e   c u r r e n t   v a l u e   o f   X ,   i . e .   1 0 
 
     / /   t h e   o r d e r   o f   e x e c u t i o n : 
 
     n p e _ q u e u e   e c h o   5 t h 
 
     n p e _ q u e u e   e c h o   6 t h 
 
     n p e _ q u e u e   - s   e c h o   3 r d 
 
     n p e _ q u e u e   - s   e c h o   4 t h 
 
     e c h o   1 s t 
 
     e c h o   2 n d 
 
     / /   j u s t   a   n i c e   s c r i p t   t h a t   l o o k s   e l e g a n t : 
 
     n p p _ c o n s o l e   l o c a l   -             / /   w i t h i n   t h i s   s c r i p t 
 
     n p e _ c o n s o l e   l o c a l   - -   v +     / /   w i t h i n   t h i s   s c r i p t 
 
     c m d   / c   t i m e   / t 
 
     n p e _ q u e u e   - v   - s   e c h o   $ ( O U T P U T ) 
 
     / /   n o w   s o m e t h i n g   r e a l l y   c r a z y ,   j u s t   b e c a u s e   w e   _ c a n _   d o   i t : 
 
     n p e _ q u e u e   n p e _ q u e u e   n p e _ q u e u e   s l e e p   2 0 0 0   L e t ' s   s l e e p   f o r   2   s e c o n d s . . . 
 
     n p e _ q u e u e   - s   n p e _ q u e u e   - s   n p e _ q u e u e   - s   s l e e p   2 0 0 0   L e t ' s   s l e e p   f o r   2   s e c o n d s . . . 
 
 R E M A R K S : 
 
     T h e   p a r a m e t e r s   + v / - v   a n d   + s / - s   c a n   b e   s p e c i f i e d   i n   a n y   o r d e r ,   b u t   a l w a y s 
 
     r i g h t   a f t e r   " n p e _ q u e u e "   a n d   b e f o r e   t h e   c o m m a n d   t o   b e   e x e c u t e d .   B o t h   t h e 
 
     p a r a m e t e r s   c a n   b e   o m i t t e d . 
 
     T h e   N P E _ Q U E U E   c o m m a n d   c a n   b e   u s e f u l   i n   c o m b i n a t i o n   w i t h   t h e   " n p p e x e c : "   p r e f i x . 
 
     F o r   e x a m p l e ,   i f   c m d . e x e   i s   r u n n i n g   i n   N p p E x e c ' s   C o n s o l e   a n d   y o u   r e a l i z e d   y o u 
 
     w a n t   s o m e   c o m m a n d   t o   b e   e x e c u t e d   r i g h t   a f t e r   t h e   c m d . e x e   h a s   f i n i s h e d ,   i t   c a n 
 
     b e   q u e u e d   r i g h t   f r o m   t h e   c m d ' s   p r o m p t : 
 
         n p p e x e c : n p e _ q u e u e   n p p _ c o n s o l e   o f f 
 
     T h i s   w i l l   c l o s e   t h e   C o n s o l e   r i g h t   a f t e r   y o u   h a v e   f i n i s h e d   t o   w o r k   w i t h   t h e 
 
     c m d . e x e .   ( N o t e :   a s   t h e   " n p p e x e c : "   p r e f i x   t e l l s   N p p E x e c   t o   s t a r t   a   c o l l a t e r a l 
 
     s c r i p t   i n   t h i s   c a s e ,   t h e   u s a g e   o f   " n p p e x e c : n p e _ q u e u e   - s   n p p _ c o n s o l e   o f f " 
 
     ( w i t h   " - s " )   w o u l d   b e   e q u i v a l e n t   t o   a   s i m p l e   " n p p e x e c : n p p _ c o n s o l e   o f f " ,   t h u s 
 
     t r y i n g   t o   e x e c u t e   i t   i m m e d i a t e l y   r a t h e r   t h a n   q u e u i n g . ) 
 
     T h e   p a r a m e t e r   " - v "   i s   n e c e s s a r y   w h e n   w o r k i n g   w i t h   l o c a l   v a r i a b l e s .   C o n s i d e r 
 
     t h e   f o l l o w i n g   e x a m p l e s : 
 
         / /   e x a m p l e   1 ,   i n s i d e   N p p E x e c ' s   s c r i p t : 
 
         s e t   l o c a l   a   =   1 2 3 4 5 
 
         n p e _ q u e u e   - v   e c h o   $ ( a ) 
 
         / /   e x a m p l e   2 ,   i n   N p p E x e c ' s   C o n s o l e   w h i l e   s o m e   p r o c e s s   i s   r u n n i n g : 
 
         n p p e x e c : n p e _ q u e u e   - v   e c h o   $ ( p i d ) 
 
     I n   b o t h   s i t u a t i o n s ,   t h e   v a r i a b l e s   $ ( a )   a n d   $ ( p i d )   a r e   l o c a l   v a r i a b l e s .   I f   t h e 
 
     " - v "   p a r a m e t e r   w a s   n o t   s p e c i f i e d ,   i t   w o u l d   m e a n :   p r i n t   t h e   v a l u e   o f   $ ( a )   o r 
 
     $ ( p i d )   a t   t h e   m o m e n t   o f   t h e   p r e v i o u s   s c r i p t   o r   p r o c e s s   h a s   f i n i s h e d .   B u t ,   a s 
 
     t h e s e   v a r i a b l e s   a r e   l o c a l   o n e s ,   t h e y   w i l l   n o t   e x i s t   a t   t h a t   m o m e n t !   S o ,   m o s t 
 
     l i k e l y ,   a n   e m p t y   s t r i n g   w i l l   b e   p r i n t e d   -   u n l e s s   t h e r e   i s   a n o t h e r ,   n o n - l o c a l , 
 
     v a r i a b l e   w i t h   t h e   s a m e   n a m e . 
 
     H e r e   i s   a n o t h e r   n o n - i n t u i t i v e   e x a m p l e :   a s   N P E _ Q U E U E   q u e u e s   a   g i v e n   c o m m a n d   a s 
 
     a   s e p a r a t e   N p p E x e c ' s   s c r i p t   ( w i t h o u t   " - s " ,   o f   c o u r s e ) ,   t h i s   s c r i p t   -   a s   a n y 
 
     s c r i p t   i n   N p p E x e c   -   d o e s   n o t   h a v e   a c c e s s   t o   l o c a l   v a r i a b l e s   o f   t h e   i n v o k e r . 
 
     F o r   e x a m p l e ,   l e t ' s   t y p e   t h e   f o l l o w i n g   c o m m a n d s   o n e   b y   o n e : 
 
         s e t   a   =   1 2 3                           / /   n o n - l o c a l   $ ( a ) 
 
         s e t   l o c a l   a   =   a b c               / /   l o c a l   $ ( a ) 
 
         e c h o   $ ( a )                               / /   p r i n t s   " a b c "   -   l o c a l   $ ( a ) 
 
         n p e _ q u e u e   e c h o   $ ( a )           / /   s e p a r a t e   s c r i p t :   p r i n t s   " 1 2 3 "   -   n o n - l o c a l   $ ( a ) 
 
         n p e _ q u e u e   - s   e c h o   $ ( a )     / /   c u r r e n t   s c r i p t :   p r i n t s   " a b c "   -   l o c a l   $ ( a ) 
 
         n p e _ q u e u e   - v   e c h o   $ ( a )     / /   s e p a r a t e   s c r i p t :   p r i n t s   " a b c "   -   c u r r e n t   $ ( a ) 
 
     W e l l ,   I   h o p e   y o u   e n j o y   i t   : ) 
 
 S E E   A L S O : 
 
     n p e _ c m d a l i a s 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     n p e _ s e n d m s g b u f l e n 
 
 U S A G E : 
 
     n p e _ s e n d m s g b u f l e n   < m a x _ l e n g t h > 
 
     n p e _ s e n d m s g b u f l e n   l o c a l   < m a x _ l e n g t h > 
 
 D E S C R I P T I O N : 
 
     S e t s   n p p _ s e n d m s g / s c i _ s e n d m s g ' s   m a x i m u m   b u f f e r   l e n g t h 
 
     W h e n   " l o c a l "   i s   s p e c i f i e d ,   t h e   c h a n g e s   a r e   a p p l i e d   l o c a l l y   t o   t h e   c u r r e n t 
 
     N p p E x e c ' s   s c r i p t   a n d   a r e   r e v e r t e d   b a c k   w h e n   t h e   c u r r e n t   s c r i p t   e n d s . 
 
 E X A M P L E S : 
 
     n p e _ s e n d m s g b u f l e n     / /   c u r r e n t   b u f f e r   l e n g t h 
 
     n p e _ s e n d m s g b u f l e n   1 0 4 8 5 7 6     / /   1   M B 
 
     n p e _ s e n d m s g b u f l e n   8 M     / /   8   M B 
 
     n p e _ s e n d m s g b u f l e n   l o c a l   4 M     / /   4   M B   l o c a l l y 
 
 R E M A R K S : 
 
     I f   t h e   s p e c i f i e d   v a l u e   i s   l e s s   t h a n   6 5 5 3 6 ,   N p p E x e c   s e t s   i t   t o   6 5 5 3 6 . 
 
     T h i s   v a l u e   i s   n o t   s a v e d   w h e n   N o t e p a d + +   e x i t s . 
 
     T o   s e t   t h i s   v a l u e   p e r m a n e n t l y ,   r e f e r   t o   " N p p E x e c _ T e c h I n f o . t x t " . 
 
 S E E   A L S O : 
 
     n p p _ s e n d m s g ,   n p p _ s e n d m s g e x ,   s c i _ s e n d m s g 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     s e l _ l o a d f r o m 
 
 U S A G E : 
 
     s e l _ l o a d f r o m   < f i l e > 
 
 D E S C R I P T I O N : 
 
     R e p l a c e s   c u r r e n t l y   s e l e c t e d   t e x t   w i t h   t h e   f i l e ' s   c o n t e n t 
 
 E X A M P L E S : 
 
     s e l _ l o a d f r o m   c : \ t e m p \ o u t p u t . t x t 
 
 R E M A R K S : 
 
     U n i c o d e   v e r s i o n   o f   N p p E x e c   c a n   r e a d   A N S I ,   U T F - 8 ,   U C S - 2   L E   a n d   U C S - 2   B E 
 
     t e x t   f i l e s . 
 
     T h e   t e x t   l o a d e d   f r o m   t h e   f i l e   i s   c o n v e r t e d   t o   t h e   c u r r e n t   S c i n t i a l l a ' s 
 
     e n c o d i n g . 
 
 S E E   A L S O : 
 
     s e l _ s a v e t o ,   s e l _ s e t t e x t ,   t e x t _ l o a d f r o m 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     s e l _ s a v e t o 
 
 U S A G E : 
 
     s e l _ s a v e t o   < f i l e > 
 
     s e l _ s a v e t o   < f i l e >   :   < e n c o d i n g > 
 
 D E S C R I P T I O N : 
 
     1 .   S a v e s   t h e   s e l e c t e d   t e x t   ( i n   i t s   c u r r e n t   e n c o d i n g )   t o   a   f i l e 
 
     2 .   S a v e s   t h e   s e l e c t e d   t e x t   ( c o n v e r t e d   t o   s p e c i f i e d   e n c o d i n g )   t o   a   f i l e 
 
           < e n c o d i n g >   m a y   b e :     a   ( A N S I ) ,   u   ( U T F - 8 ) ,   w   ( U C S - 2   L E ) 
 
 E X A M P L E S : 
 
     s e l _ s a v e t o   c : \ t e m p \ o u t p u t . t x t   / /   m a y   b e   A N S I ,   U T F - 8   o r   D B C S   f i l e 
 
     s e l _ s a v e t o   c : \ t e m p \ o u t p u t A N S I . t x t   : a           / /   s a v e   a s   A N S I   f i l e 
 
     s e l _ s a v e t o   c : \ t e m p \ o u t p u t U T F 8 . t x t   : u           / /   s a v e   a s   U T F - 8   ( w i t h   B O M )   f i l e 
 
     s e l _ s a v e t o   c : \ t e m p \ o u t p u t U T F 8 . t x t   : u +         / /   s a v e   a s   U T F - 8   ( w i t h   B O M )   f i l e 
 
     s e l _ s a v e t o   c : \ t e m p \ o u t p u t U T F 8 . t x t   : u -         / /   s a v e   a s   U T F - 8   ( w i t h o u t   B O M )   f i l e 
 
     s e l _ s a v e t o   c : \ t e m p \ o u t p u t U n i c o d e . t x t   : w     / /   s a v e   a s   U C S - 2   L E   ( w i t h   B O M )   f i l e 
 
 R E M A R K S : 
 
     S E L _ S A V E T O   w i t h   t h e   < e n c o d i n g >   p a r a m e t e r   o m i t t e d   s a v e s   t h e   t e x t   i n   t h e 
 
     S c i n t i l l a ' s   c u r r e n t   e n c o d i n g   ( i t   c a n   b e   A N S I ,   D B C S   o r   U T F - 8 ) . 
 
     S o ,   i f   y o u   w a n t   t o   s a v e   t h e   t e x t   a s   U C S - 2   L E   ( U n i c o d e   i n   W i n d o w s ) ,   y o u 
 
     m u s t   s p e c i f y   t h e   " : w "   p a r a m e t e r . 
 
 S E E   A L S O : 
 
     s e l _ l o a d f r o m ,   s e l _ s e t t e x t ,   t e x t _ s a v e t o 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     s e l _ s e t t e x t ,   s e l _ s e t t e x t + 
 
 U S A G E : 
 
     s e l _ s e t t e x t   < t e x t > 
 
     s e l _ s e t t e x t +   < t e x t > 
 
 D E S C R I P T I O N : 
 
     R e p l a c e s   c u r r e n t l y   s e l e c t e d   t e x t   w i t h   t h e   t e x t   s p e c i f i e d 
 
 E X A M P L E S : 
 
     s e l _ s e t t e x t   T h i s   t e x t   h a s   r e p l a c e d   t h e   p r e v i o u s l y   s e l e c t e d   t e x t 
 
     s e l _ s e t t e x t   $ ( I N P U T )       / /   s e e :   i n p u t b o x 
 
     s e l _ s e t t e x t   $ ( O U T P U T )     / /   s e e :   n p e _ c o n s o l e   v + 
 
     s e l _ s e t t e x t   $ ( S Y S . P A T H ) 
 
     s e l _ s e t t e x t +   A   t e x t   w i t h   n e w   l i n e : \ r \ n n e w   l i n e 
 
 R E M A R K S : 
 
     U s e   s e l _ s e t t e x t +   t o   i n s e r t   s p e c i a l   c h a r a c t e r s : 
 
     \ n     -   l i n e   f e e d   ( L F )   c h a r a c t e r ; 
 
     \ r     -   c a r r i a g e   r e t u r n   ( C R )   c h a r a c t e r ; 
 
     \ t     -   t a b u l a t i o n   c h a r a c t e r ; 
 
     \ \     -   \ ;     \ \ n   -   \ n ;     \ \ t   -   \ t . 
 
     T o   r e p l a c e   t h e   e n t i r e   t e x t   r a t h e r   t h a n   t h e   s e l e c t e d   t e x t ,   u s e 
 
     t h e   f o l l o w i n g   s c r i p t : 
 
         / /   1 .   d i s a b l i n g   r e d r a w i n g 
 
         s c i _ s e n d m s g   0 x 0 0 0 B   0   / /   W M _ S E T R E D R A W   F A L S E 
 
         / /   2 .   s e l e c t i n g   a l l   t h e   t e x t 
 
         s c i _ s e n d m s g   S C I _ S E L E C T A L L 
 
         / /   3 .   e n a b l i n g   r e d r a w i n g 
 
         s c i _ s e n d m s g   0 x 0 0 0 B   1   / /   W M _ S E T R E D R A W   T R U E 
 
         / /   4 .   r e p l a c i n g   t h e   t e x t 
 
         s e l _ s e t t e x t   . . . 
 
 S E E   A L S O : 
 
     s e l _ l o a d f r o m ,   s e l _ s a v e t o 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     t e x t _ l o a d f r o m 
 
 U S A G E : 
 
     t e x t _ l o a d f r o m   < f i l e > 
 
 D E S C R I P T I O N : 
 
     R e p l a c e s   t h e   e n t i r e   t e x t   w i t h   t h e   f i l e ' s   c o n t e n t 
 
 E X A M P L E S : 
 
     t e x t _ l o a d f r o m   c : \ t e m p \ o u t p u t . t x t 
 
 R E M A R K S : 
 
     U n i c o d e   v e r s i o n   o f   N p p E x e c   c a n   r e a d   A N S I ,   U T F - 8 ,   U C S - 2   L E   a n d   U C S - 2   B E 
 
     t e x t   f i l e s . 
 
     T h e   t e x t   l o a d e d   f r o m   t h e   f i l e   i s   c o n v e r t e d   t o   t h e   c u r r e n t   S c i n t i a l l a ' s 
 
     e n c o d i n g . 
 
 S E E   A L S O : 
 
     t e x t _ s a v e t o ,   s e l _ l o a d f r o m 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     t e x t _ s a v e t o 
 
 U S A G E : 
 
     t e x t _ s a v e t o   < f i l e > 
 
     t e x t _ s a v e t o   < f i l e >   :   < e n c o d i n g > 
 
 D E S C R I P T I O N : 
 
     1 .   S a v e s   t h e   e n t i r e   t e x t   ( i n   i t s   c u r r e n t   e n c o d i n g )   t o   a   f i l e 
 
     2 .   S a v e s   t h e   e n t i r e   t e x t   ( c o n v e r t e d   t o   s p e c i f i e d   e n c o d i n g )   t o   a   f i l e 
 
           < e n c o d i n g >   m a y   b e :     a   ( A N S I ) ,   u   ( U T F - 8 ) ,   w   ( U C S - 2   L E ) 
 
 E X A M P L E S : 
 
     t e x t _ s a v e t o   c : \ t e m p \ o u t p u t . t x t   / /   m a y   b e   A N S I ,   U T F - 8   o r   D B C S   f i l e 
 
     t e x t _ s a v e t o   c : \ t e m p \ o u t p u t A N S I . t x t   : a         / /   s a v e   a s   A N S I   f i l e 
 
     t e x t _ s a v e t o   c : \ t e m p \ o u t p u t U T F 8 . t x t   : u         / /   s a v e   a s   U T F - 8   ( w i t h   B O M )   f i l e 
 
     t e x t _ s a v e t o   c : \ t e m p \ o u t p u t U T F 8 . t x t   : u +       / /   s a v e   a s   U T F - 8   ( w i t h   B O M )   f i l e 
 
     t e x t _ s a v e t o   c : \ t e m p \ o u t p u t U T F 8 . t x t   : u -       / /   s a v e   a s   U T F - 8   ( w i t h o u t   B O M )   f i l e 
 
     t e x t _ s a v e t o   c : \ t e m p \ o u t p u t U n i c o d e . t x t   : w   / /   s a v e   a s   U C S - 2   L E   ( w i t h   B O M )   f i l e 
 
 R E M A R K S : 
 
     T E X T _ S A V E T O   w i t h   t h e   < e n c o d i n g >   p a r a m e t e r   o m i t t e d   s a v e s   t h e   t e x t   i n   t h e 
 
     S c i n t i l l a ' s   c u r r e n t   e n c o d i n g   ( i t   c a n   b e   A N S I ,   D B C S   o r   U T F - 8 ) . 
 
     S o ,   i f   y o u   w a n t   t o   s a v e   t h e   t e x t   a s   U C S - 2   L E   ( U n i c o d e   i n   W i n d o w s ) ,   y o u 
 
     m u s t   s p e c i f y   t h e   " : w "   p a r a m e t e r . 
 
 S E E   A L S O : 
 
     t e x t _ l o a d f r o m ,   s e l _ s a v e t o 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     c l i p _ s e t t e x t 
 
 U S A G E : 
 
     c l i p _ s e t t e x t   < t e x t > 
 
 D E S C R I P T I O N : 
 
     S e t s   t h e   C l i p b o a r d   t e x t 
 
 E X A M P L E S : 
 
     e c h o   T e x t   i n   t h e   C l i p b o a r d   ( w a s ) :   $ ( C L I P B O A R D _ T E X T ) 
 
     c l i p _ s e t t e x t   T h i s   i s   t h e   n e w   C l i p b o a r d   t e x t 
 
     e c h o   T e x t   i n   t h e   C l i p b o a r d   ( n o w ) :   $ ( C L I P B O A R D _ T E X T ) 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     i f 
 
 U S A G E : 
 
     1 .   i f   < c o n d i t i o n >   g o t o   < l a b e l > 
 
     2 .   i f   < c o n d i t i o n >   t h e n 
 
               . . . 
 
           e n d i f 
 
     3 .   i f   < c o n d i t i o n >   t h e n 
 
               . . . 
 
           e l s e 
 
               . . . 
 
           e n d i f 
 
     4 .   i f   < c o n d i t i o n 1 >   t h e n 
 
               . . . 
 
           e l s e   i f   < c o n d i t i o n 2 >   t h e n 
 
               . . . 
 
           e l s e 
 
               . . . 
 
           e n d i f 
 
     5 .   i f   < c o n d i t i o n 1 >   g o t o   < l a b e l 1 > 
 
           e l s e   i f   < c o n d i t i o n 2 >   g o t o   < l a b e l 2 > 
 
           e l s e 
 
               . . . 
 
           e n d i f 
 
 D E S C R I P T I O N : 
 
     I f   t h e   c o n d i t i o n   i s   t r u e ,   j u m p s   t o   t h e   s p e c i f i e d   l a b e l . 
 
     I f   t h e   c o n d i t i o n   i s   f a l s e ,   p r o c e e d s   t o   t h e   n e x t   l i n e . 
 
     *   I f   t h e   s p e c i f i e d   l a b e l   c a n   n o t   b e   f o u n d   w i t h i n   t h e   c u r r e n t   s c r i p t , 
 
     t h i s   c o m m a n d   r e p o r t s   a n   e r r o r   a n d   p r o c e e d s   t o   t h e   n e x t   l i n e . 
 
     * *   Y o u   s h o u l d   a l w a y s   p l a c e   " i f "   a n d   " g o t o "   o n   t h e   s a m e   l i n e . 
 
     A v a i l a b l e   c o n d i t i o n s : 
 
     a   = =   b     -   e q u a l :                           1   = =   1 ,   " A b "   = =   " A b " 
 
     a   =   b       -   e q u a l :                           2   =   2 ,     " A a "   =   " A a " 
 
     a   ! =   b     -   n o t   e q u a l :                   1   ! =   2 ,   " A b "   ! =   " A B " 
 
     a   < >   b     -   n o t   e q u a l :                   1   < >   2 ,   " A a "   < >   " A " 
 
     a   >   b       -   g r e a t e r :                       2   >   1 ,     " A b "   >   " A a " 
 
     a   <   b       -   l e s s :                           - 2   <   1 ,     " a "   <   " a b " 
 
     a   > =   b     -   g r e a t e r   o r   e q u a l :     0   > =   0 ,   " A B "   > =   " A A " 
 
     a   < =   b     -   l e s s   o r   e q u a l :           1   < =   2 ,   " A "   < =   " A A " 
 
     a   ~ =   b     -   e q u a l   n o   c a s e :           " A A "   ~ =   " a a " 
 
     *   Y o u   c a n   u s e   v a r i a b l e s   a n d   c o n s t a n t s   a s   t h e   o p e r a n d s : 
 
         " i f   $ ( v a r 1 )   = =   $ ( v a r 2 )   g o t o   E q u a l V a r s " 
 
         " i f   $ ( v a r )   ! =   1 0   g o t o   N o t E q u a l T o 1 0 " 
 
         " i f   A B C   <   $ ( v a r )   g o t o   G r e a t e r T h a n A B C " 
 
     * *   E a c h   c o n d i t i o n   a l w a y s   e x p e c t s   t w o   o p e r a n d s :   t h e   l e f t   o n e   a n d   t h e 
 
     r i g h t   o n e .   T h u s ,   " i f   $ ( v a r )   g o t o   L a b e l "   i s   n o t   v a l i d   -   y o u   s h o u l d 
 
     s p e c i f y   e i t h e r   " i f   $ ( v a r )   ! =   0   g o t o   L a b e l "   f o r   a   n u m b e r   o r 
 
     " i f   " $ ( v a r ) "   ! =   " "   g o t o   L a b e l "   f o r   a   s t r i n g . 
 
     * * *   I f   b o t h   o p e r a n d s   a r e   d e c i m a l   n u m b e r s ,   a   n u m e r i c   c o m p a r i s o n   i s 
 
     u s e d .   O t h e r w i s e   t h e   o p e r a n d s   a r e   c o m p a r e d   a s   s t r i n g s . 
 
     T h u s ,   - 2   <   - 1   ( d e c i m a l   n u m b e r s )   a n d   " - 2 "   >   " - 1 "   ( s t r i n g s ) . 
 
     * * * *   N o   a d d i t i o n a l   c a l c u l a t i o n s   a r e   p e r f o r m e d   d u r i n g   t h e   c o m p a r i s o n . 
 
     T h u s ,   " i f   3   = =   1   +   2   g o t o   L a b e l "   i s   n o t   a   v a l i d   n u m e r i c   c o m p a r i s o n 
 
     b e c a u s e   " 1   +   2 "   i s   n o t   c a l c u l a t e d   a n d   r e m a i n s   a s   i s ,   s o   t h e   s t r i n g 
 
     c o m p a r i s o n   i s   u s e d   i n   t h i s   c a s e   ( " 3 "   i s   c o m p a r e d   w i t h   " 1   +   2 " ) . 
 
     A l l   t h e   c a l c u l a t i o n s   s h o u l d   b e   p e r f o r m e d   i n   a d v a n c e   -   o r   u s e   I F ~   . 
 
     * * * * *   N o t i c e   t h e   u s a g e   o f   d o u b l e   q u o t e s   a n d   s p a c e s   b e t w e e n   t h e 
 
     o p e r a n d s   w h i l e   c o m p a r i n g   s t r i n g s   t h a t   c o n t a i n   ' > ' ,   ' < '   a n d   s o   o n : 
 
         i f   " 1   > "   <   " 2 "   g o t o   L a b e l 1     / /   " 1   > "   v s .   " 2 " 
 
         i f   " 1 "   >   " <   2 "   g o t o   L a b e l 2     / /   " 1 "   v s .   " <   2 " 
 
     * * * * * *   N e s t e d   c o n d i t i o n s   a r e   s u p p o r t e d . 
 
     * * * * * * *   T h e   k e y w o r d   " t h e n "   c a n   b e   o m i t t e d . 
 
 E X A M P L E S : 
 
     / / / / / / / / / / / / / / / / / / / / / / / / 
 
     / /   E x a m p l e   1 : 
 
     / /   e m u l a t i n g   " f o r   ( i   =   1 ;   i   < =   1 0 ;   i   + =   1 )   {   c o u t   < <   i   < <   e n d l ;   } " 
 
     s e t   l o c a l   i   ~   1                     / /   i n i t i a l i z a t i o n :   " i   =   1 " 
 
     : f o r _ i                                       / /   s t a r t   o f   t h e   c y c l e 
 
     e c h o   $ ( i )                                 / /   t h e   c y c l e   b o d y :   " c o u t   < <   i   < <   e n d l ; " 
 
     s e t   l o c a l   i   ~   $ ( i )   +   1       / /   i t e r a t i o n :   " i   + =   1 " 
 
     i f   $ ( i )   < =   1 0   g o t o   f o r _ i   / /   c o n d i t i o n :   " i   < =   1 0 " 
 
     / /   -   e q u i v a l e n t   t o   " i   =   1 ;   d o   {   c o u t   < <   i   < <   e n d l ;   i   + =   1 ;   }   w h i l e   ( i   < =   1 0 ) ; " 
 
     / / / / / / / / / / / / / / / / / / / / / / / / 
 
     / /   E x a m p l e   2 : 
 
     / /   c o m p a r e   N   l e a d i n g   c h a r a c t e r s   o f   S 1   w i t h   N   t r a i l i n g   c h a r a c t e r s   o f   S 2 
 
     s e t   l o c a l   S 1   =   e x t e n s i o n     / /   i n p u t :   S 1 
 
     s e t   l o c a l   S 2   =   s o m e   t e x t     / /   i n p u t :   S 2 
 
     s e t   l o c a l   N   =   3                       / /   i n i t i a l i z a t i o n :   N 
 
     s e t   l o c a l   s u b 1   ~   s u b s t r   0   $ ( N )   $ ( S 1 )       / /   g e t   N   l e a d i n g   c h a r a c t e r s   o f   S 1 
 
     s e t   l o c a l   s u b 2   ~   s u b s t r   - $ ( N )   -   $ ( S 2 )     / /   g e t   N   t r a i l i n g   c h a r a c t e r s   o f   S 2 
 
     i f   " $ ( s u b 1 ) "   = =   " $ ( s u b 2 ) "   t h e n 
 
         e c h o   s u b s t r i n g s   a r e   e q u a l :   " $ ( s u b 1 ) "   = =   " $ ( s u b 2 ) " 
 
     e l s e 
 
         e c h o   s u b s t r i n g s   a r e   n o t   e q u a l :   " $ ( s u b 1 ) "   ! =   " $ ( s u b 2 ) " 
 
     e n d i f 
 
     / / / / / / / / / / / / / / / / / / / / / / / / 
 
     / /   E x a m p l e   3 : 
 
     / /   e m u l a t i n g   " I F   1   < =   x   A N D   x   <   5 " 
 
     i f   1   >   $ ( x )   g o t o   @ I f _ E n d     / /   o p p o s i t e   t o   1   < =   x 
 
     i f   $ ( x )   > =   5   g o t o   @ I f _ E n d   / /   o p p o s i t e   t o   x   <   5 
 
     : @ I f _ T r u e 
 
     / /   t h e   c o n d i t i o n   i s   t r u e ,   d o   s o m e t h i n g . . . 
 
     e c h o   T r u e :   1   < =   x   <   5 
 
     : @ I f _ E n d 
 
     / / / / / / / / / / / / / / / / / / / / / / / / 
 
     / /   E x a m p l e   4 : 
 
     / /   e m u l a t i n g   " I F   s   = =   ' A B C '   O R   s   = =   ' D E F '   T H E N   . . .   E L S E   . . . " 
 
     i f   " $ ( s ) "   = =   " A B C "   g o t o   @ I f _ T r u e 
 
     i f   " $ ( s ) "   = =   " D E F "   g o t o   @ I f _ T r u e 
 
     e l s e 
 
         / /   t h e   c o n d i t i o n   i s   f a l s e ,   d o   s o m e t h i n g . . . 
 
         e c h o   F a l s e :   s   i s   n e i t h e r   " A B C "   n o r   " D E F " 
 
     e n d i f 
 
     g o t o   @ I f _ E n d 
 
     : @ I f _ T r u e 
 
     / /   t h e   c o n d i t i o n   i s   t r u e ,   d o   s o m e t h i n g . . . 
 
     e c h o   T r u e :   s   i s   e i t h e r   " A B C "   o r   " D E F " 
 
     : @ I f _ E n d 
 
     / / / / / / / / / / / / / / / / / / / / / / / / 
 
     / /   E x a m p l e   5 : 
 
     / /   n e s t e d   c o n d i t i o n s 
 
     s e t   l o c a l   x   =   0 
 
     s e t   l o c a l   y   =   1 
 
     i f   $ ( x )   = =   0   t h e n 
 
         e c h o   x   i s   0 
 
         i f   $ ( y )   = =   0   t h e n 
 
             e c h o   y   i s   0 
 
         e l s e 
 
             e c h o   y   i s   n o t   0 
 
         e n d i f 
 
     e l s e 
 
         e c h o   x   i s   n o t   0 
 
     e n d i f 
 
 R E M A R K S : 
 
     A s   y o u   c a n   s e e ,   d i f f e r e n t   I F - G O T O   c o n s t r u c t i o n s   i n   c o m b i n a t i o n   w i t h 
 
     a n o t h e r   G O T O s   a n d   L A B E L s   c a n   s e r v e   a s   I F - E L S E ,   F O R   a n d   W H I L E . 
 
     T h i s   a l l o w s   t o   a p p l y   m o r e - o r - l e s s   c o m p l i c a t e d   c o n d i t i o n a l   l o g i c 
 
     i n s i d e   N p p E x e c ' s   s c r i p t s . 
 
 S E E   A L S O : 
 
     i f ~ ,   e l s e ,   e n d i f ,   g o t o ,   l a b e l ,   s e t 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     i f ~ 
 
 U S A G E : 
 
     1 .   i f ~   < c o n d i t i o n >   g o t o   < l a b e l > 
 
     2 .   i f ~   < c o n d i t i o n >   t h e n 
 
               . . . 
 
           e n d i f 
 
     3 .   i f ~   < c o n d i t i o n >   t h e n 
 
               . . . 
 
           e l s e 
 
               . . . 
 
           e n d i f 
 
     4 .   i f ~   < c o n d i t i o n 1 >   t h e n 
 
               . . . 
 
           e l s e   i f ~   < c o n d i t i o n 2 >   t h e n 
 
               . . . 
 
           e l s e 
 
               . . . 
 
           e n d i f 
 
     5 .   i f ~   < c o n d i t i o n 1 >   g o t o   < l a b e l 1 > 
 
           e l s e   i f ~   < c o n d i t i o n 2 >   g o t o   < l a b e l 2 > 
 
           e l s e 
 
               . . . 
 
           e n d i f 
 
 D E S C R I P T I O N : 
 
     F i r s t   c a l c u l a t e s   t h e   o p e r a n d s ,   t h e n   c h e c k s   t h e   c o n d i t i o n . 
 
     I f   t h e   c o n d i t i o n   i s   t r u e ,   j u m p s   t o   t h e   s p e c i f i e d   l a b e l . 
 
     I f   t h e   c o n d i t i o n   i s   f a l s e ,   p r o c e e d s   t o   t h e   n e x t   l i n e . 
 
     *   I f   t h e   s p e c i f i e d   l a b e l   c a n   n o t   b e   f o u n d   w i t h i n   t h e   c u r r e n t   s c r i p t , 
 
     t h i s   c o m m a n d   r e p o r t s   a n   e r r o r   a n d   p r o c e e d s   t o   t h e   n e x t   l i n e . 
 
     * *   Y o u   s h o u l d   a l w a y s   p l a c e   " i f "   a n d   " g o t o "   o n   t h e   s a m e   l i n e . 
 
     A v a i l a b l e   c o n d i t i o n s : 
 
     a   = =   b     -   e q u a l :                           1   = =   1 ,     N P P M S G   = =   W M _ U S E R   +   1 0 0 0 
 
     a   =   b       -   e q u a l :                           2   =   2 ,       $ ( x )   +   5   =   $ ( x )   +   5 
 
     a   ! =   b     -   n o t   e q u a l :                   1   ! =   2 ,     $ ( x )   +   1   ! =   s i n ( $ ( y ) ) 
 
     a   < >   b     -   n o t   e q u a l :                   1   < >   2 ,     N P P M S G   < >   p i 
 
     a   >   b       -   g r e a t e r :                       2   >   1 ,       $ ( x )   +   1   >   1 
 
     a   <   b       -   l e s s :                           - 2   <   1 ,       $ ( x )   -   1 0   <   $ ( x )   -   5 
 
     a   > =   b     -   g r e a t e r   o r   e q u a l :     0   > =   0 ,     $ ( x )   +   0   > =   $ ( x ) 
 
     a   < =   b     -   l e s s   o r   e q u a l :           1   < =   2 ,     $ ( x )   -   2   < =   $ ( y )   -   2 
 
 R E M A R K S : 
 
     I F ~   d e a l s   o n l y   w i t h   n u m b e r s   a n d   n u m e r i c   c a l c u l a t i o n s . 
 
     A   s t r i n g   o p e r a n d   w i l l   c a u s e   a   s y n t a x   e r r o r . 
 
 S E E   A L S O : 
 
     i f ,   e l s e ,   e n d i f ,   g o t o ,   l a b e l ,   s e t 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     l a b e l ,   : 
 
 U S A G E : 
 
     l a b e l   < L a b e l N a m e > 
 
     l a b e l   : < L a b e l N a m e > 
 
     : < L a b e l N a m e > 
 
 D E S C R I P T I O N : 
 
     D e c l a r e s   a   l a b e l   w i t h i n   t h e   c u r r e n t   s c r i p t . 
 
     Y o u   c a n   j u m p   t o   a   l a b e l   u s i n g   t h e   G O T O   c o m m a n d . 
 
 E X A M P L E S : 
 
     : L a b e l 1 
 
     l a b e l   M y L a b e l B 
 
     : C 
 
     l a b e l   4 
 
     l a b e l   : 4     / /   e q u a l   t o   l a b e l   4 
 
 R E M A R K S : 
 
     Y o u   c a n   g i v e   a n y   n a m e   t o   y o u r   l a b e l .   L e a d i n g   a n d   t r a i l i n g   s p a c e s   a r e 
 
     i g n o r e d .   L e a d i n g   ' : '   i s   i g n o r e d   ( i . e .   L A B E L   X   i s   t h e   s a m e   a s   L A B E L   : X ) . 
 
     E a c h   l a b e l   " l i v e s "   w i t h i n   a   s c r i p t   w h e r e   i t   i s   d e c l a r e d .   Y o u   c a n   n o t 
 
     j u m p   t o   a   l a b e l   l o c a t e d   i n s i d e   a n o t h e r   s c r i p t   -   e i t h e r   o u t e r   o r   i n n e r 
 
     o n e .   ( A n d   t h i s   i s   t h e   d i f f e r e n c e   b e t w e e n   l a b e l s   a n d   v a r i a b l e s :   e a c h 
 
     s c r i p t   h a s   i t s   o w n   s e t   o f   l a b e l s   w h i c h   a r e   n o t   s h a r e d   b e t w e e n   s c r i p t s , 
 
     w h e r e a s   a n y   d e c l a r e d   v a r i a b l e   i s   v i s i b l e   a n d   e x i s t s   e v e r y w h e r e   -   u n l e s s 
 
     i t   i s   a   l o c a l   v a r i a b l e ,   o f   c o u r s e . ) 
 
     T h u s ,   y o u   c a n   d e c l a r e   l a b e l s   w i t h   t h e   s a m e   n a m e s   i n s i d e   d i f f e r e n t 
 
     s c r i p t s   ( b u t   n o t   w i t h i n   o n e   s c r i p t ) .   E . g .   y o u   m a y   h a v e   l a b e l s   n a m e d 
 
     A ,   B   a n d   C   i n s i d e   S o m e S c r i p t 1   a n d   t h e   s a m e   l a b e l   n a m e s   A ,   B   a n d   C 
 
     i n s i d e   S o m e S c r i p t 2   -   a n d   t h e s e   l a b e l s   a r e   d i f f e r e n t   b e c a u s e   t h e y 
 
     " e x i s t "   i n   d i f f e r e n t   s c r i p t s ,   e v e n   i f   S o m e S c r i p t 1   t h e n   u s e s 
 
     N P P _ E X E C   t o   e x e c u t e   S o m e S c r i p t 2   o r   v i c e   v e r s a . 
 
 S E E   A L S O : 
 
     g o t o ,   i f ,   i f ~ 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     g o t o 
 
 U S A G E : 
 
     g o t o   < L a b e l N a m e > 
 
     g o t o   : < L a b e l N a m e > 
 
 D E S C R I P T I O N : 
 
     J u m p s   t o   t h e   l a b e l 
 
 E X A M P L E S : 
 
     / / / / / / / / / / / / / / / / / / / / / / / / 
 
     / /   T h e o r e t i c a l   e x a m p l e : 
 
     / /   P u r e   G O T O s   w i t h   s h o r t   l a b e l   n a m e s 
 
     g o t o   1 
 
     : 2 
 
     g o t o   3 
 
     : 1 
 
     g o t o   2 
 
     : 3 
 
     / / / / / / / / / / / / / / / / / / / / / / / / 
 
     / /   T h e   v e r y   s a m e   e x a m p l e , 
 
     / /   u s i n g   s h o r t   l a b e l   n a m e s   w i t h   p r e c e d i n g   ' : ' 
 
     g o t o   : 1 
 
     : 2 
 
     g o t o   : 3 
 
     : 1 
 
     g o t o   : 2 
 
     : 3 
 
     / / / / / / / / / / / / / / / / / / / / / / / / 
 
     / /   T h e o r e t i c a l   e x a m p l e : 
 
     / /   E n d l e s s   c y c l e   w i t h   n e a t   l a b e l   n a m e . . . 
 
     : N e a t   L a b e l   N a m e 
 
     g o t o   N e a t   L a b e l   N a m e 
 
     / /   . . . n o w   y o u   c a n   e i t h e r   w a i t   u n t i l   t h e   n u m b e r   o f   e x e c u t e d   G O T O s 
 
     / /   e x c e e d s   t h e   v a l u e   o f   G o T o _ M a x C o u n t   -   o r   j u s t   c l o s e   t h e   C o n s o l e . 
 
     / /   W h e n   t h e   C o n s o l e   i s   c l o s e d ,   t h e   s c r i p t   e x e c u t i o n   i s   s t o p p e d . 
 
     / / / / / / / / / / / / / / / / / / / / / / / / 
 
     / /   P r a c t i c a l   e x a m p l e : 
 
     / /   I F - G O T O 
 
     i f   " $ ( a ) "   = =   " "   g o t o   @ a _ i s _ e m p t y 
 
     e c h o   a   i s   n o t   e m p t y :   a = $ ( a ) 
 
     g o t o   d o n e 
 
     : @ a _ i s _ e m p t y 
 
     e c h o   a   i s   e m p t y 
 
     : d o n e 
 
 R E M A R K S : 
 
     Y o u   c a n   g i v e   a n y   n a m e   t o   y o u r   l a b e l .   L e a d i n g   a n d   t r a i l i n g   s p a c e s   a r e 
 
     i g n o r e d .   L e a d i n g   ' : '   i s   i g n o r e d   ( i . e .   G O T O   X   i s   t h e   s a m e   a s   G O T O   : X ) . 
 
     E a c h   l a b e l   " l i v e s "   w i t h i n   a   s c r i p t   w h e r e   i t   i s   d e c l a r e d .   Y o u   c a n   n o t 
 
     j u m p   t o   a   l a b e l   l o c a t e d   i n s i d e   a n o t h e r   s c r i p t   -   e i t h e r   o u t e r   o r   i n n e r 
 
     o n e .   ( A n d   t h i s   i s   t h e   d i f f e r e n c e   b e t w e e n   l a b e l s   a n d   v a r i a b l e s :   e a c h 
 
     s c r i p t   h a s   i t s   o w n   s e t   o f   l a b e l s   w h i c h   a r e   n o t   s h a r e d   b e t w e e n   s c r i p t s , 
 
     w h e r e a s   a n y   d e c l a r e d   v a r i a b l e   i s   v i s i b l e   a n d   e x i s t s   e v e r y w h e r e   -   u n l e s s 
 
     i t   i s   a   l o c a l   v a r i a b l e ,   o f   c o u r s e . ) 
 
 S E E   A L S O : 
 
     l a b e l ,   i f ,   i f ~ ,   e x i t 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     e l s e 
 
 U S A G E : 
 
     i f   < c o n d i t i o n > 
 
         . . . 
 
     e l s e   i f   < c o n d i t i o n > 
 
         . . . 
 
     e l s e 
 
         . . . 
 
     e n d i f 
 
 D E S C R I P T I O N : 
 
     I m p l e m e n t s   I F   . . .   E L S E   . . .   E N D I F 
 
     o r                   I F   . . .   E L S E   I F   . . .   E N D I F 
 
     o r                   I F   . . .   E L S E   I F   . . .   E L S E   . . .   E N D I F 
 
     o r                   I F   . . .   E L S E   I F   . . .   E L S E   I F   . . .   E N D I F 
 
     a n d   s i m i l a r   c o n s t r u c t i o n s . 
 
 E X A M P L E S : 
 
     s e e :   i f 
 
 S E E   A L S O : 
 
     i f ,   i f ~ ,   e n d i f 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     e n d i f 
 
 U S A G E : 
 
     i f   < c o n d i t i o n > 
 
         . . . 
 
     e n d i f 
 
 D E S C R I P T I O N : 
 
     T h e   e n d   o f   t h e   I F   . . .   E N D I F   c o n s t r u c t i o n . 
 
 E X A M P L E S : 
 
     s e e :   i f ,   e l s e 
 
 S E E   A L S O : 
 
     i f ,   i f ~ ,   e l s e 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     e x i t 
 
 U S A G E : 
 
     e x i t 
 
     e x i t   0 
 
     e x i t   - 1 
 
 D E S C R I P T I O N : 
 
     E x i t s   ( a b o r t s )   t h e   c u r r e n t   N p p E x e c ' s   s c r i p t . 
 
     T h e   ' e x i t '   a n d   ' e x i t   0 '   m e a n   " s o f t   e x i t " :   w h e n   s u c h   c o m m a n d   i s   l o c a t e d   i n 
 
     N p p E x e c ' s   s c r i p t   b e i n g   N P P _ E X E C - e d ,   i t   a b o r t s   o n l y   t h i s   N P P _ E X E C - e d   s c r i p t . 
 
     T h e   ' e x i t   - 1 '   m e a n s   " h a r d   e x i t " :   w h e n   t h i s   c o m m a n d   i s   l o c a t e d   i n   N p p E x e c ' s 
 
     s c r i p t   b e i n g   N P P _ E X E C - e d ,   i t   a b o r t s   t h e   r o o t   s c r i p t . 
 
 E X A M P L E S : 
 
     / /   T o   i l l u s t r a t e   t h e   d i f f e r e n c e   b e t w e e n   " s o f t "   a n d   " h a r d "   e x i t , 
 
     / /   l e t ' s   l o o k   a t   t h e   f o l l o w i n g   2   s c r i p t s : 
 
     / / 
 
     / /   : :   T h i s   i s   S c r i p t - 1   : : 
 
     e c h o   S c r i p t - 1   :   b e f o r e   S c r i p t - 2 
 
     n p p _ e x e c   " S c r i p t - 2 " 
 
     e c h o   S c r i p t - 1   :   a f t e r   S c r i p t - 2 
 
     / / 
 
     / /   : :   T h i s   i s   S c r i p t - 2   : : 
 
     e c h o   S c r i p t - 2   :   b e f o r e   ' e x i t ' 
 
     e x i t     / /   " s o f t "   e x i t 
 
     e c h o   S c r i p t - 2   :   a f t e r   ' e x i t ' 
 
     / / 
 
     / /   N o w   l e t ' s   r u n   t h e   S c r i p t - 1 . 
 
     / /   I t   p r i n t s : 
 
     / /       S c r i p t - 1   :   b e f o r e   S c r i p t - 2 
 
     / /       S c r i p t - 2   :   b e f o r e   ' e x i t ' 
 
     / /       S c r i p t - 1   :   a f t e r   S c r i p t - 2 
 
     / /   i . e .   o n l y   t h e   S c r i p t - 2   e x i t e d ,   w h e r e a s   t h e   S c r i p t - 1   c o n t i n u e d . 
 
     / /   N o w   l e t ' s   m o d i f y   t h e   S c r i p t - 2   t o   u s e   t h e   e x i t   t y p e   o f   - 1 : 
 
     / / 
 
     / /   : :   T h i s   i s   S c r i p t - 2   : : 
 
     e c h o   S c r i p t - 2   :   b e f o r e   ' e x i t ' 
 
     e x i t   - 1     / /   " h a r d "   e x i t 
 
     e c h o   S c r i p t - 2   :   a f t e r   ' e x i t ' 
 
     / / 
 
     / /   N o w   l e t ' s   r u n   t h e   S c r i p t - 1 . 
 
     / /   I t   p r i n t s : 
 
     / /       S c r i p t - 1   :   b e f o r e   S c r i p t - 2 
 
     / /       S c r i p t - 2   :   b e f o r e   ' e x i t ' 
 
     / /   a n d   t h a t ' s   a l l . 
 
     / /   I . e .   t h e   ' e x i t   - 1 '   h a s   a b o r t e d   t h e   S c r i p t - 1   a s   w e l l . 
 
     / / 
 
     / /   U s a g e   e x a m p l e : 
 
     s e t   l o c a l   e r r o r   =   S o m e   e r r o r 
 
     i f   " $ ( e r r o r ) "   ! =   " " 
 
         m e s s a g e b o x   " $ ( e r r o r ) "   : :   e r r 
 
         e x i t 
 
     e n d i f 
 
     e c h o   T h e r e   w a s   n o   e r r o r ,   c o n t i n u i n g . . . 
 
 S E E   A L S O : 
 
     g o t o ,   i f ,   i f ~ 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     p r o c _ i n p u t 
 
 U S A G E : 
 
     p r o c _ i n p u t   < s t r i n g > 
 
 D E S C R I P T I O N : 
 
     S e n d s   a   g i v e n   s t r i n g   t o   t h e   r u n n i n g   p r o c e s s . 
 
     T h e   s t r i n g   c a n   b e   s i n g l e - l i n e   o r   m u l t i - l i n e . 
 
 E X A M P L E S : 
 
     p r o c _ i n p u t   $ ( S E L E C T E D _ T E X T )     / /   s e n d s   s e l e c t e d   t e x t   t o   t h e   p r o c e s s 
 
     p r o c _ i n p u t   $ ( C L I P B O A R D _ T E X T )   / /   s e n d s   c l i p b o a r d   t e x t   t o   t h e   p r o c e s s 
 
     s e t   l o c a l   s   ~   s t r u n e s c a p e   e c h o   1 2 3 \ n e c h o   4 5 6 
 
     p r o c _ i n p u t   $ ( s ) 
 
     p r o c _ i n p u t   e x i t 
 
 S E E   A L S O : 
 
     p r o c _ s i g n a l ,   @ e x i t _ c m d   ( " h e l p   @ e x i t _ c m d " ) ,   n p p _ c o n s o l e 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     p r o c _ s i g n a l 
 
 U S A G E : 
 
     p r o c _ s i g n a l   < s i g n a l > 
 
     p r o c _ s i g n a l   < s i g n a l >   < t i m e o u t > 
 
 D E S C R I P T I O N : 
 
     p r o c _ s i g n a l   c t r l - c                 / /   s e n d s   C t r l - C   t o   t h e   p r o c e s s 
 
     p r o c _ s i g n a l   c t r l - b r e a k         / /   s e n d s   C t r l - B r e a k   t o   t h e   p r o c e s s 
 
     p r o c _ s i g n a l   w m _ c l o s e             / /   s e n d s   W M _ C L O S E   t o   t h e   p r o c e s s 
 
     p r o c _ s i g n a l   w m _ c l o s e   1 0 0 0   / /   w a i t   f o r   r e a c t i o n   d u r i n g   1 0 0 0   m s 
 
 E X A M P L E S : 
 
     p r o c _ s i g n a l   C t r l C                                   / /   s e n d s   C t r l - C 
 
     p r o c _ s i g n a l   C t r l - C   C t r l - B r e a k           / /   s e n d s   C t r l - C ,   t h e n   C t r l - B r e a k 
 
     p r o c _ s i g n a l   c t r l - b r e a k   w m _ c l o s e       / /   s e n d s   C t r l - B r e a k ,   t h e n   W M _ C L O S E 
 
     p r o c _ s i g n a l   c t r l b r e a k   w m c l o s e   5 0 0   / /   C t r l - B r e a k ,   w a i t s   5 0 0   m s ,   W M _ C L O S E 
 
 R E M A R K S : 
 
     T h i s   c o m m a n d   i s   e x p e c t e d   t o   b e   s e n t   w h i l e   a   c h i l d   c o n s o l e   p r o c e s s   i s   r u n n i n g 
 
     i n   N p p E x e c ' s   C o n s o l e .   S o   t h e   u s u a l   s y n t a x   o f   t h i s   c o m m a n d   w i l l   b e : 
 
         n p p e x e c : p r o c _ s i g n a l   < s i g n a l > 
 
     A l s o   t h i s   c o m m a n d   c a n   b e   c o m b i n e d   w i t h   $ ( @ e x i t _ c m d ) ,   e . g .   t o   b r e a k   t h e   c h i l d 
 
     p r o c e s s   a u t o m a t i c a l l y   w h e n   N p p E x e c ' s   C o n s o l e   i s   c l o s e d   ( a n d   w h e n   t h e   c h i l d 
 
     p r o c e s s   c a n   n o t   b e   f i n i s h e d   b y   s o m e   r e g u l a r   e x i t   c o m m a n d ) : 
 
         n p p e x e c : s e t   l o c a l   @ e x i t _ c m d   =   n p p e x e c : p r o c _ s i g n a l   C t r l C   W M C L O S E 
 
         / /   n o w   c l o s e   t h e   N p p E x e c ' s   C o n s o l e   -   o r   t y p e : 
 
         n p p e x e c : n p p _ c o n s o l e   o f f 
 
     T h i s   l a t e s t   e x a m p l e   a c t u a l l y   h a s   a   s i m i l a r   e f f e c t   a s   t h e   f o l l o w i n g   o n e : 
 
         n p p e x e c : s e t   l o c a l   @ e x i t _ c m d   =   n p p e x e c : t a s k k i l l   / p i d   $ ( P I D ) 
 
     A n y w a y ,   i t ' s   r e c o m m e n d e d   t o   u s e   a n   e x i t   c o m m a n d   ( s u c h   a s   " e x i t "   f o r   c m d   a n d 
 
     " e x i t ( ) "   f o r   p y t h o n )   w h e n e v e r   p o s s i b l e   t o   l e t   t h e   p r o c e s s   e x i t   n o r m a l l y . 
 
 S E E   A L S O : 
 
     p r o c _ i n p u t ,   @ e x i t _ c m d   ( " h e l p   @ e x i t _ c m d " ) ,   n p p _ c o n s o l e 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 C O M M A N D :     s l e e p 
 
 U S A G E : 
 
     s l e e p   < m s > 
 
     s l e e p   < m s >   < t e x t > 
 
 D E S C R I P T I O N : 
 
     S l e e p s   d u r i n g   < m s >   m i l l i s e c o n d s . 
 
     I f   t h e   < t e x t >   p a r a m e t e r   i s   s p e c i f i e d ,   i t   i s   p r i n t e d   f i r s t . 
 
 E X A M P L E S : 
 
     / /   w i t h o u t   t h e   t e x t : 
 
     s l e e p   1 0 0 0   / /   s l e e p s   d u r i n g   1   s e c o n d 
 
     / /   w i t h   t h e   t e x t : 
 
     s e t   l o c a l   t   =   2 5 0 0 
 
     s l e e p   $ ( t )   " S l e e p i n g   d u r i n g   $ ( t )   m i l l i s e c o n d s . . . " 
 
 R E M A R K S : 
 
     I t   i s   n o t   n e c e s s a r y   t o   u s e   q u o t e s   f o r   t h e   < t e x t >   p a r a m e t e r   a s   t h i s   c o m m a n d 
 
     e x p e c t s   e i t h e r   1   o r   2   p a r a m e t e r s ,   n o t   m o r e . 
 
 S E E   A L S O : 
 
     e c h o ,   s e t 
 
 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 V A R I A B L E :     @ e x i t _ c m d   /   @ e x i t _ c m d _ s i l e n t 
 
 U S A G E : 
 
     s e t   @ e x i t _ c m d   =   e x i t   / /   s e t s   t h e   c h i l d   p r o c e s s ' e s   e x i t   c o m m a n d 
 
     s e t   @ e x i t _ c m d _ s i l e n t   =   e x i t   / /   s e t s   t h e   c h i l d   p r o c e s s ' e s   s i l e n t   e x i t   c o m m a n d 
 
 D E S C R I P T I O N : 
 
     W h e n   N p p E x e c ' s   C o n s o l e   i s   b e i n g   c l o s e d   w h i l e   a   c h i l d   c o n s o l e   p r o c e s s   i s   r u n n i n g 
 
     i n   i t ,   t h e   s p e c i f i e d   e x i t   c o m m a n d   i s   s e n t   t o   t h e   r u n n i n g   p r o c e s s   a u t o m a t i c a l l y . 
 
     T h e   e x i t   c o m m a n d   i s   e x p e c t e d   t o   f i n i s h   t h e   p r o c e s s   n o r m a l l y   -   o t h e r w i s e ,   i f   t h e 
 
     p r o c e s s   d o e s   n o t   f i n i s h ,   t h e   C o n s o l e   w o n ' t   c l o s e . 
 
     I n   c a s e   o f   @ e x i t _ c m d ,   t h e   e x i t   c o m m a n d   i s   p r i n t e d   i n   t h e   C o n s o l e . 
 
     I n   c a s e   o f   @ e x i t _ c m d _ s i l e n t ,   t h e   e x i t   c o m m a n d   i s   n o t   p r i n t e d   i n   t h e   C o n s o l e . 
 
     N o t e :   t h e   C o n s o l e   c a n   b e   c l o s e d   e i t h e r   m a n u a l l y   ( b y   c l i c k i n g   t h e   " x "   b u t t o n ) 
 
     o r   p r o g r a m m a t i c a l l y   ( v i a   " n p p _ c o n s o l e   o f f " ) . 
 
 E X A M P L E S : 
 
     s e t   l o c a l   @ e x i t _ c m d   =   e x i t   / /   t h e   e x i t   c o m m a n d   i s   " e x i t " 
 
     c m d   / /   r u n n i n g   t h e   c m d . e x e 
 
     / /   n o w   c l o s e   t h e   C o n s o l e   -   " e x i t "   w i l l   b e   s e n t   t o   t h e   c m d . e x e   a u t o m a t i c a l l y 
 
 R E M A R K S : 
 
     I t   i s   p o s s i b l e   t o   c l o s e   N p p E x e c ' s   C o n s o l e   b y   t y p i n g   " n p p _ c o n s o l e   o f f "   i n   i t . 
 
     E v e n   w h e n   a   c h i l d   c o n s o l e   p r o c e s s   ( s u c h   a s   " c m d "   o r   " p y t h o n   - u   - i " )   i s   r u n n i n g 
 
     a n d   w a i t i n g   f o r   t h e   i n p u t ,   t h e   C o n s o l e   c a n   b e   c l o s e d   b y   t y p i n g : 
 
         n p p e x e c : n p p _ c o n s o l e   o f f 
 
 S E E   A L S O : 
 
     s e t ,   p r o c _ s i g n a l ,   n p p _ c o n s o l e 
 
 
 
 